Deploy a static site
Deploy built web pages as a site with an HTTPS address.
Before you begin#
- Your built files, such as the
dist/folder thatnpm run buildcreates. - Permission to create projects, which only administrators have.
If you upload a zip, create it from inside the folder so that index.html is at the top of the zip:
cd dist
zip -r ../site.zip .Common mistake
Zipping the dist folder itself puts the page at dist/index.html. Without an index.html at the top, the version is refused.
1. Create a project#
- Open Deploy › Projects Select Create project.
- Enter a name and an address label Use lowercase letters, numbers and hyphens, for example
launch-page.
Address labels are never reused
Even after the project is deleted, no other organization gets its address. Check the spelling before you create the project.
2. Upload#
On the project's Deploy tab, drop a folder, a .zip or an index.html on the upload area (or choose one), then select Upload and build.
The platform builds a new version and, before it can go live, scans the files for secrets and personal data.
In an AI tool connected to Agent Lab MCP, type:
Deploy dist/ to the Agent Lab project launch-page. Show me the preview address first, and wait for my OK before going live.See Deploy with an AI tool to set it up.
3. Go live#
A project's first version goes live on its own once it builds. Visitors see it at the public address:
https://launch-page--acme.hosting.agentlab.runWhile your workspace has only the production environment, every later version also goes live on its own once it builds. With more than one environment, later versions wait: open the newest version's preview address to check it, then select Go live on the Deploy tab (see Go live).
Next steps#
- Versions and going live
- Addresses and access: to show the site to a few people only, make the project private with a password.