DocsHosting
Host a website
The Hosting add-on ($15/month, available on every plan including Free) turns a project under ~/Sites/<name>/ into a website. Ask an agent to build it with ordinary source code, publish plain HTML/CSS/JavaScript, or use Site Editor's visual sections.
Websites and real applications
You can ask for a Next.js application in JavaScript or TypeScript, or a Python application using Flask, FastAPI, or Django. Existing PHP, WordPress, and Laravel projects also have deployment profiles. Express, plain Node.js, or another HTTP application can provide its own Dockerfile.vercel with dependencies and a start command. Your project contains normal source and dependency files; no site.json or Site Editor is required. Agents inspect the project and preserve your framework when making changes.
Applications deploy to Vercel from the site owner's synced Drive files. Once a production build and its domain setup are ready, the application uses <name>.sites.jonkum.in and any verified custom domain. /s/<name>/ redirects to the ready application address with the path and query preserved. The agent reports the public address, build status, and any remaining setup. See Build applications from source for prerequisites, file tools, supported profiles, and verification.
Site Editor is an optional way to compose a site from visual sections stored in site.json. Its design review checks that format. It does not replace source editing, a framework build, or checking that an application's routes work.
How static publishing works
- A site is a folder. Everything under
~/Sites/<name>/is the site: anindex.html, styles, images, or the output of a build tool. There is no manifest and no install step. - Ask for it. Tell the assistant "host this for me" or "build me a site for my bakery and put it online". It creates the site, writes the files, and publishes. You can also manage sites yourself in Settings › Sites.
- Publishing is versioned. Every publish creates a new immutable version. The previous version stays live until the new one is fully uploaded, and the last ten versions are kept so you can roll back from Settings › Sites in one click.
- Your site is live at two addresses:
/s/<name>/on this domain, and<name>.sites.jonkum.in. A site name is lowercase letters, digits and hyphens, 3 to 63 characters, and must be unique.
Sites are served from a global CDN. HTML pages are served through us so we can count views; images, scripts and other assets are served directly from the CDN edge.
Static hosting limits
| Per account with the add-on | |
|---|---|
| Sites | 5 |
| Size per site | 25 MB, up to 400 files |
| Bandwidth | 25 GB per month |
Publishing refuses with a clear message when a site is over its size or file cap. When the bandwidth cap is reached, the site pauses until the next month. Cancelling the add-on takes every site offline at the end of the paid period; your files stay in your home folder.
Static-site contact forms and leads
A plain HTML form that posts to /api/sites/<name>/form is stored as a lead. Add a hidden honeypot text field named _honeypot so bots that fill it are dropped silently. Set a "forms to" address in Settings › Sites to also receive each submission by email. Field names name, email, phone and company are recognised so leads can be turned into Contacts automatically.
Static-site page views
Turn on analytics for a site in Settings › Sites and a tiny script is added to every page to count views. No cookies are set and no visitor is identified.
Custom domains for sites and applications
Buy a domain, or attach one you already own, from Settings › Sites › Domain (or Business › Website › Domain & Edge) - or just ask the assistant, "get me riverside-plumbing.com." See Domains for how buying, pricing and attaching work end to end. NextOS connects a verified domain to the site's active static publication or application project. The <name>.sites.jonkum.in address stays available. For an application, domain setup and the production build must both be ready; status shows any DNS or verification step still needed.
Static single-page apps
If your site handles its own routing, include a 200.html identical to index.html. Deep links such as /s/<name>/dashboard then serve the app shell instead of a 404.
Static-site search engines
Sites are hidden from search engines until you turn on "indexable" for that site. That way a half-built site never gets crawled.