Publishing
Deploy your app to the web with one click. Served from a global CDN with automatic SSL certificates.
Click Publish in your app's dashboard. Your app goes live at your-app.serenitiesai.app within seconds. Add a custom domain for your own branding.
On this page
How Publishing Works
Build
Your pages and components are compiled with Vite into optimized production bundles with code-splitting.
Upload
Built files are uploaded to cloud storage. Previous build files are replaced on each publish.
Deploy
CDN cache is purged globally. Your app is live within seconds at your subdomain.
SSL
SSL certificates are provisioned automatically. HTTPS works out of the box.
The Publish button shows live progress while this runs — a short stage label (e.g. “Compiling 24 pages…”) next to the spinner, updated as the build moves through preparing → installing → compiling → uploading → finalizing.
What Gets Deployed
| What | Details |
|---|---|
| Pages | All non-draft pages are compiled and deployed. Each page is lazy-loaded for fast initial loads. |
| Components | Shared components are bundled and reused across pages. |
| SDK | Auto-generated SDK with entities (tables), user (auth), files, functions, payments, flows, email, realtime, serverFetch methods. |
| Vendor chunks | React and other libraries are bundled once and cached across all pages. |
| Auth pages | Login and signup pages are included automatically when auth is enabled. |
Performance: The build system scales to 10,000+ pages with per-page lazy loading and shared vendor chunks.
Updating Your App
After making changes to your pages, components, or settings, click Publish again. The build process runs and your changes go live within seconds.
Backend functions, environment variables, access rules, and database data update immediately — no republish needed. Only page/component code changes require republishing.
Unpublishing
Click Unpublish to take your app offline. The subdomain will stop serving your app. Your pages, data, and settings are preserved — you can republish at any time.
Custom Domains
Connect your own domain to your published app. Supports both subdomains (www.yourdomain.com) and apex domains (yourdomain.com).
See the full Custom Domains guide for step-by-step DNS setup instructions.
Git Integration
Optionally connect your app to a GitHub repository. When enabled, publishing also commits your page and component code to your repo.
Features:
- Auto-commit on publish
- Branch management (create, switch, merge)
- Rollback to any previous commit
- Full commit history