# Create or connect a site

> Start a new client site from Shortcake's template, or bring in an existing site without touching it.

## Create a new site

Ask your assistant to create a site, or choose **Create site** in the [console](https://shortcake.wun.ai). Pick the client workspace, enter the site name and domain, and Shortcake sets up:

- a Git repository from the approved Astro template,
- static hosting with a protected production branch, and
- a first preview you can review.

Setup runs in the background and you can follow its progress. If a step is interrupted, retrying picks up where it stopped instead of creating duplicates.

### Custom domains

To use the client's own domain, Shortcake shows the DNS record that proves ownership. The client (or whoever manages their DNS) adds it; Shortcake never changes DNS itself. The domain is attached once ownership is verified and HTTPS is ready.

## Connect an existing site

Choose **Connect existing site** to bring in a site that already lives in GitLab and deploys to Netlify. Before anything is linked, Shortcake checks that:

- you are allowed to access the repository and hosting site,
- the site is a supported static Astro build,
- the production branch is protected, and
- the site isn't already connected elsewhere.

You'll see a summary and the current production deploy before confirming. **Connecting is read-only**: it doesn't change the code, DNS or hosting, and it doesn't deploy anything. The current production deploy becomes the baseline for future releases.
