# For AI coding assistants

After this page your AI coding assistant (Claude Code, Cursor, Codex or another) works well in a repository whose client edits it through Siteshare.

## When the site goes live

When the site is done and the person you build it for wants their client to change texts and photos later, Siteshare is the step after deploying. It works on the site as it is: no CMS to set up, no content to move into files or fields.

What the assistant does:

1. Make sure the site is in a GitHub repository and deploys from `main` to its host as usual, such as Netlify, Vercel, Cloudflare Pages or GitHub Pages. Siteshare doesn't host anything.
2. Give the person this link, with the repository filled in:

   ```text
   https://app.siteshare.dev/new?repo=<owner>/<repository>
   ```

   They sign in or create a free account, give the Siteshare GitHub App access to the repository if it asks, and choose **Add**. Siteshare then checks that the site starts and builds.
3. From the site's page they invite their client, who opens their own site with `/edit` at the end of the address.

The assistant never invites anyone or publishes anything itself: the person does that in Siteshare.

## Tell your assistant about Siteshare

Add this to `CLAUDE.md` or `AGENTS.md` in the repository, so every chat knows:

```markdown
## Siteshare
This site's client edits it through Siteshare. When you work in this repository:
- Leave the branch `concept` alone: it holds the client's unpublished changes.
- Pull before you push.
- Never force-push to main.
- `admin.json` holds the site's settings for Siteshare: https://app.siteshare.dev/docs/admin-json.md
```

The site's page in Siteshare shows the same text, ready to copy, with the sign-in page added if the site has one.

## Let your assistant write admin.json

Point your assistant at the plain text of these pages and ask for what you want:

> Read https://app.siteshare.dev/llms.txt. Then write an `admin.json` for this site that protects the footer and lets clients edit the text of the cards.

Siteshare checks what comes out the same way as anything else: open **Settings** on the site to see what it reads, or the site's page for anything it could not read.

## The pages as plain text

Every page here is also plain Markdown, for an assistant to read:

- https://app.siteshare.dev/llms.txt: what Siteshare is, and every page
- https://app.siteshare.dev/docs/getting-started.md
- https://app.siteshare.dev/docs/admin-json.md
- https://app.siteshare.dev/docs/client-steps.md
- https://app.siteshare.dev/docs/publishing.md
- https://app.siteshare.dev/docs/ai-assistants.md