Sites

Build, host and share websites and web apps from a prompt in ZeroTwo

Sites lets ZeroTwo build, host, refine and share websites and web apps from a prompt. Each Site is published at an address of the form <name>.zerotwo.site. Building a Site uses agent credits like any other Work or Code task. You manage your Sites in the Space section of the web and desktop apps, and the iOS and Android apps have a Sites list with sharing, domains, environment variables and analytics.

A new Site is visible only to you. Ask ZeroTwo to deploy it, then decide who else may open it.

Get started with Sites

Open Space > Sites and choose Create Site. This starts a new chat with the Sites plugin attached and a prompt beginning "Create a website that...", which you finish. You can also mention the Sites plugin or the word "website" in any chat.

  1. Describe

    Say who the Site is for, what it should do, and what data it keeps.

  2. Review

    ZeroTwo builds and opens a preview in a browser tab. Check content, behavior and data handling.

  3. Refine

    Keep chatting to request changes. Type @ and choose the Site by name to refer to an existing Site from any chat.

  4. Share

    When deployment succeeds, the chat shows a card that opens the Site. Use Share on the Site to set the audience and copy the link.

Find and reuse Sites

The Sites list has All, Pinned, Owned by you and Shared with you views, and a search box that matches a Site's name, address or hostname. A Site's … menu pins it, and Remix on a Site starts a new chat that builds your own copy. A Site's page has Settings, Analytics, Database, Plugins and Scheduled tabs. Database shows the data the Site keeps, and Scheduled lists the scheduled tasks linked to it. Plugins lists the apps the live Site uses, each marked Can view data or Can view and change data, and lets you Connect an app, Allow it or Remove access.

When a Site asks to use your connected apps, a page names the Site and asks you to choose Allow or Not now. A design can also become a Site: choose Publish as Site from Share in Design. If the address's HTTPS certificate is still being issued, ZeroTwo asks you to try again in about two minutes.

Prompt Sites for common tasks

State the audience, the core experience and any data needs, for example a request tracker where each visitor signs in and their entries are saved. Mention durable data or file uploads explicitly so the right storage is added.

Build a request tracker where each visitor signs in and sees only their own requests. Save every entry so it is still there on the next visit, and keep the authorization checks on the server.

Review Site analytics

Open a Site from the Sites list and choose the Analytics tab. It shows Unique visitors and Page views for the last 7d or 30d, charted hourly for 7 days and daily for 30, with a Top pages table. An Events card below lists the custom events your Site records. If traffic is very high the figures are sampled and marked approximate, and a Site whose tracking is not turned on shows nothing yet.

Add sign-in for visitors

A Site can offer optional sign-in so it can save progress or keep per-person records. Ask ZeroTwo to add it, and keep authorization checks on the server. Visitors sign in with their ZeroTwo account.

How it works

For compatibility, the sign-in and sign-out paths are /signin-with-zerotwo and /signout-with-zerotwo, and the server receives the visitor's identity in oai-authenticated-user-* headers, including oai-authenticated-user-email. Base authorization on the user id or email, not on the name.

Understand versions and deployments

Sites are persistent hosted projects. Saving a version builds a candidate from a commit of the Site's source, and deploying a version publishes it and reports its address. ZeroTwo's default handoff is a private deployment, so the Site stays restricted until you change who has access. Ask ZeroTwo in chat to list a Site's saved versions when you need an earlier one. The Sites page itself does not offer a version browser.

Choose a supported site shape

Start from the starter ZeroTwo scaffolds, or ask it to check that an existing project is compatible.

NeedAsk for
Static contentNo persistent state
Records, progress, scoresA D1 database
File uploadsR2 object storage
Sign-in for visitorsThe authentication add-on

Skip storage for state that only lives in the page.

Control access and secrets

Open Share on a Site, or choose Manage on the Sharing row in its Settings tab, and use Who has access. The menu offers Only you and Anyone with the link. A Site that is not open to the public is shown as Restricted access, which is how it is labeled once you have added people or groups. Choosing Only you clears every person and group you had added. Only an anyone-with-the-link Site is open to the public.

Invite specific people

Under restricted access, an owner can add a person by email with Add viewer, and then choose Send invitation to email them the Site link. The email form appears only when invitations are enabled for your account, and Send invitation works once the Site is deployed and restricted access is in effect. Visitors sign in to ZeroTwo with the invited email. Account users who already have access are listed as Viewer or Editor, and Remove takes access away. In the Site's Settings tab, an owner can also give organization or workspace groups Viewer, Editor or No access; organization administrators create and edit those groups.

Configure environment variables

In the Site's Settings tab, Environment variables holds API keys and other values the Site needs, and you can store a value as a secret. Names starting with VITE_, PUBLIC_, NEXT_PUBLIC_, REACT_APP_ or VUE_APP_ are built into the published files, where anyone can read them, so never put a secret in one. A change takes effect the next time the Site is published.

Connect private HTTP services

Private HTTP services connects a service on your own network to a Site through a connector you run with cloudflared. Each connection is limited to one IP address and port, and Revoke cuts it off.

Change a Site address

In the Settings tab, the Domain row sets the address. Use lowercase letters, digits and hyphens, up to 50 characters. Changing it breaks every existing link to the old address, and reserved or taken names are rejected.

Connect a custom domain

Choose Add domain under Custom domains, enter a hostname you own, and add the verification records shown at your DNS provider. Choose Check status to refresh; a domain shows Verification pending, Active or Verification failed, and Remove disconnects it.

Review before you share

  • Check content, links, forms and uploads for secrets or material you do not have rights to.
  • Test as the intended visitor, including sign-in.
  • Decide how personal data is collected and follow the privacy laws that apply to you.
  • Pick the narrowest sharing option and confirm the audience.

Take down or delete a Site

Restrict sharing to hide a Site. To remove it for good, open its Settings tab, find the Danger zone, and choose Delete site. This permanently deletes the Site and its published files, the address stops working, and it cannot be recovered.

Understand limits

Each account can have up to 25 Sites, and the Sites list shows a counter as you get close. A Site's packaged archive can be at most 100 MB.