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 apps. Only administrators can create apps.
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 an app#
- Open Deploy › Apps Select Create app.
- 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 app is deleted, no other organization gets its address. Check the spelling before you create the app.
2. Upload#
On the app'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 app 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#
An app's first version goes live on its own once it builds. Visitors see it at the public address:
https://launch-page--acme.hosting.agentlab.runLater versions don't go live on their own. Open a version's preview address to check it, then select Go live on the Deploy tab.
Next steps#
- Versions, going live and rolling back
- Addresses and access: to show the site to a few people only, make the app private with a password.