ZIP root matters
Place index.html and 404.html at the ZIP output root, not inside an extra nested build folder.
Features
Import a ZIP archive that contains a static website and let StaticX unpack, validate, and publish it as a versioned site.
Place index.html and 404.html at the ZIP output root, not inside an extra nested build folder.
Most static generators can produce a dist or build folder. Zip the contents of that folder and upload it to StaticX.
In StaticX, importing or creating a site starts the first version. Later explicit publishes create the next immutable versions.
Most ZIP deployment problems come from the wrong root folder. StaticX expects the website files at the archive root.
Prepare the final HTML, CSS, JavaScript, images, PDFs, and 404.html that should be hosted.
Compress the contents of dist, build, out, or your site folder, not the parent folder itself.
StaticX imports the files, starts version 1 when the site is created, and later publishes create new immutable versions.
If index.html is trapped inside an extra folder, the site can look empty or fail to route correctly. StaticX surfaces files through the dashboard so humans and agents can confirm what was imported.
Once imported, the files belong to the same versioning model as every other deploy path. Dashboard, CLI, API, MCP, manual ZIP, and link imports should all produce a clear release history.
The ZIP root should contain index.html directly.
A custom 404 page keeps missing routes professional and helps agents satisfy deploy rules.
Do not upload node_modules, caches, local config secrets, or source files that are not served.
Short, practical answers for using this page safely.
Zip the contents of the output folder so index.html is at the archive root.
Yes in the StaticX product model. Creating or importing a site starts version 1, and explicit publish/deploy actions create later immutable versions.
Yes. Every deploy path should send the output root and produce consistent version history.