Run the TwinStack site from your browser

1. Create an account with your name, email and a password of at least 8 characters, or log in if you already have one.
2. Connect GitHub from the dashboard. GitHub asks you to approve four permissions: read your profile, read your email address, access your repositories (public and private, read and write) and update GitHub Actions workflows. The app needs repository access to list, copy and push your repositories. It needs the workflow permission because the site includes a deploy workflow, and GitHub refuses pushes that contain workflow files without it. The connection stays with your account, so you only do this once. You can disconnect it from the dashboard at any time.
3. Check that you can use the site manager. Opening a site runs its build scripts on the server, so it's limited to approved GitHub accounts. If you see “Site management isn't enabled for your account”, ask the administrator to add the GitHub username you connected.
4. Add your Anthropic API key on the dashboard if you want to use Claude (Edit with Claude and scheduled pages). The key is checked with Anthropic, then stored encrypted on the server for your account. Usage is billed to your Anthropic account, and you can remove the key any time. Everything else works without a key.

Repositories that belong to an organisation only appear if the organisation allows this app, under Settings → Third-party access.

1. Open the dashboard and find twinstack-site. Use the filter box and the Private / Public / All switch.
2. Click Duplicate, choose a name for your copy and whether it's private, then click Create & push.
3. The new repository is created in your account with every branch, tag and commit. Once it's done, it's added to your list.

Issues, pull requests, wikis, repository settings and Git LFS files aren't copied. If copying fails partway, try again with the same name: the empty repository that was left behind is reused. The template itself can't be managed. Your changes always go into your own copy.

Click Manage site next to your copy. The first time, the server clones the repository and installs its dependencies, which takes about a minute. After that, opening the site fetches the latest from GitHub. Work you haven't published yet is kept, even if you close the page.

One command runs at a time. Its output appears in the Output panel, where you can also cancel it. Claude edits have a Preview button that shows the proposed file without writing it.

1. Open the Changes tab. Expand a file to see its diff, or select files and discard them.
2. Write a commit message and choose how to publish:
   • New branch and pull request (recommended). Your changes go to a new branch, named twinstack/<date>-<time> unless you pick a name, and a pull request is opened into the default branch. Review and merge it on GitHub. Later commits on that branch update the same pull request.
   • Push directly to the current branch. This skips review. If the site's deploy workflow builds from that branch, the live site changes straight away.
3. When the pull request is merged, click Start a new change to go back to the default branch. If GitHub has newer commits, click Update to latest. Both are available once there are no unpublished changes.