Skip to main content
Solved

Lucid for Developer portal error: zip END header not found [no file] while uploading package

  • September 25, 2025
  • 15 replies
  • 194 views

Forum|alt.badge.img+3

I'm trying to upload a custom shape library (XYZ-shape-library, based on example-shape-library from GitHub) to the Lucid Developer Portal for our enterprise instance. Using npx lucid-package bundle on Windows, but getting error on Developer portal while uploading zip package that i created using  npx lucid-package@latest bundle ---

  • Portal Error: "We could not upload that file. Please try again with a different .zip file.
    Shape library error in GHD-shape-library: Unknown error: zip END header not found [<no file>]"

Tried:

  • Running extension in localhost and then tested in Lucidcharts without any issues
  • Tired edge and chrome browsers
  • Re-bundling with lucid-package --clean.
  • Manual package.zip with manifest.json + shapes.lcsz.
  • Tried using another extension from Lucid’s Github samples

Questions:

  • Known lucid-package or portal bug?
  • Any upload workaround?
  • Help troubleshooting 

#Lucidchart #ShapeLibrary #DeveloperPortal #bundle package error

 

Best answer by bhupesh68

The key was changing the path from shapelibraries\example-shape-library.lcsz to shapelibraries\\example-shape-library.lcsz. On Windows, a single backslash \ in a double-quoted string is interpreted as an escape character, so it must be escaped with another backslash. Thank you team support and help.

Comments

Forum|alt.badge.img+2
  • Lucid product team
  • September 25, 2025

Hey ​@bhupesh68, thanks for raising this.

Our team is looking into this now and will get back to you shortly. The package bundle command and upload does work on linux based operating systems if that is available to you in the interim.

 


Forum|alt.badge.img+3
  • Author
  • October 3, 2025

HI ​@chasefreeman  I also tried on Linux with no success. In fact, I used a standard cookie-cutter example from Lucid’s GitHub repo, tested it, bundled it, and uploaded it to the Developer Portal but still got the same error. 

 


Forum|alt.badge.img+2
  • Lucid product team
  • October 3, 2025

Can you provide the exact command you are running as well as what sample extension from the github repo you tried to bundle? It is possible one of the sample extensions is out of date. Any other relevant information you could provide about operating system, extension sdk version, etc… might be useful to help us narrow down what is happening.

For reference, I was able to successfully bundle and upload the `example-card-integration` on Linux as of an hour ago.


Forum|alt.badge.img+3
  • Author
  • October 6, 2025

Please the details requested: 

 


Forum|alt.badge.img+2
  • Lucid product team
  • October 6, 2025

Interesting. We still are unable to reproduce the error. 

Would you be willing to upload the bundled sample extension from our public repository after running that command so we can investigate the contents?


Forum|alt.badge.img+3
  • Author
  • October 7, 2025

Example Package  Please see the attached package for your reference.


Forum|alt.badge.img+2
  • Lucid product team
  • October 7, 2025

Thanks, we will investigate and I’ll update this thread when we know more.


Forum|alt.badge.img+3
  • Author
  • October 13, 2025

Hi ​@chasefreeman Is there an update on this use please.


Forum|alt.badge.img+2
  • Lucid product team
  • October 13, 2025

Hey ​@bhupesh68

We’ve been able to identify that the difference between your package and one that we bundled and successfully uploaded. The difference being that the bundle you sent has an empty shape library file.

As to the why, we’re not certain. We’re still investigating, but don’t have an update for you as to why this is occurring. We’ve been unable to replicate the issue you are running into with bundling on any operating system. 

 


Forum|alt.badge.img+3
  • Author
  • October 15, 2025

Thanks ​@chasefreeman  Since the code we’re exchanging is quite generic, could you share the version that’s working for you? I’ll test deploying that package on my end. If it works, it likely means the issue lies in how we’re bundling packages locally in our setup.


Forum|alt.badge.img+2
  • Lucid product team
  • October 15, 2025

Yeah, happy to provide.

Here is the example shape library package that I bundled and uploaded in testing


Forum|alt.badge.img+3
  • Author
  • October 16, 2025

Thank you ​@chasefreeman . I tried upload the zip you shared by changing the id in the manifest file and got his error:  

The only difference I find in my manifest vs yours is that mine is having version 1.0.3


Forum|alt.badge.img+2
  • Lucid product team
  • October 16, 2025

Apologies. I think I may have accidentally sent one that is broken by mistake. This one should be able to be uploaded 


Forum|alt.badge.img+2
  • Lucid product team
  • October 16, 2025

It’s also possible there was an issue with recompressing the file. When you unzip the package to edit the manifest, make sure when rezipping you do not zip the containing folder but all of the items inside of the folder together instead. Please let me know if you run into any issues with that or have any questions. 


Forum|alt.badge.img+3
  • Author
  • Answer
  • October 20, 2025

The key was changing the path from shapelibraries\example-shape-library.lcsz to shapelibraries\\example-shape-library.lcsz. On Windows, a single backslash \ in a double-quoted string is interpreted as an escape character, so it must be escaped with another backslash. Thank you team support and help.