Step-by-step walkthrough of the New site wizard in the dashboard.

Before you start

A site is created with a guided wizard in the dashboard. When you choose a BehindGate subdomain, the wizard has five steps; a custom domain would add a Provisioning step, but custom domains are not yet supported.

Open the wizard

1. In the sidebar, select + New site.

If your workspace has no sites yet, you'll see No sites yet and Create your first site to start hosting., and the wizard may open automatically as Create your first site.

Step 1: Details

Name the site and choose how people reach it.

1. Enter a Site name.

2. Choose BehindGate subdomain.

   • BehindGate subdomain is reachable instantly and secured automatically.
   • Custom domain shows Not available in this environment yet. Custom domains are not yet supported, so use a BehindGate subdomain.

3. Select Continue.

Step 2: Address

Choose your site's address.

1. Enter a Subdomain. Use lowercase letters, numbers and hyphens, up to 63 characters, with no leading or trailing hyphen.
2. Check the preview under Your site will live at, which shows the full URL your site will be reachable at.
3. Select Continue.

Leaving the Address step creates the site. The later steps act on the real, existing site.

A BehindGate subdomain is live immediately, so the wizard skips the Provisioning step. This is why a subdomain site shows five steps instead of six.

Step 3: Access

Choose how visitors sign in. The wizard shows Choose how visitors sign in. New sites are private by default.

1. Choose a sign-in method:

   • Email — Only people whose email matches a domain or address you allow.
   • Single sign-on — Gate behind your identity provider (SSO).

2. Optionally turn on Allow public apps.

   This lets an app on this site be made public (reachable without sign-in). It is off by default as a safeguard, and is a separate, per-app opt-in. You can change it later in the site's settings.

3. Select Continue.

Step 4: Sign-in

Configure the method you chose, then test it by opening your site.

If you chose Email:

1. Under Allowed email domains, add the domains whose users can sign in. Anyone with an email at these domains can sign in.
2. Optionally add individual addresses under Allowed email addresses (optional) for individual guests outside the domains above.
3. Add at least one allowed domain or address.

Once configured, open your live site to test sign-in.

Step 5: First deploy

Upload your built site to the root app, or skip and deploy later.

1. Choose an Upload type:

   • Zip file — A single .zip of your built site (the contents of your dist/ folder).
   • Folder — Pick your build output folder. We'll upload its files.

2. Select Upload & finish to upload now.

This step is optional. Select Finish to skip it and deploy to the root app any time from its page.