How it works

From repository to your first published change

Sitehand reads your repository and reports what it can edit. Setup from the app and publishing are coming.

Steps marked Coming show how that part of setup will work once it ships.

1

Connect your repository

Install the Sitehand GitHub App and tell Sitehand which repository holds your site.

Connect a site

Site nameNorthwind Dental
GitHub repositorynorthwind/websiteowner/repo, for example acme/website.
App folderapps/siteLeave empty when the site is at the top of the repository.
Continue to GitHub
2

Sitehand reads your site

Sitehand reads the repository and reports the framework, the content it found, and anything it can't edit yet. Nothing is written.

Northwind DentalSetup
What Sitehand found
FrameworkAstro
Package managerpnpm
Content folderssrc/content
Collections
blogMarkdownEditable
pricingJSONEditable
teamYAMLRead only
team is not editable yet. YAML files are read only.
3Coming

Choose what's editable

Review the proposed setup. Sitehand puts it on a branch. You open the pull request on GitHub and merge it.

Coming: setup from the app is waiting on its final proof run.

Setup sent
Committed to sitehand/onboarding
.sitehand/site.json.sitehand/schemas/blog.json.sitehand/manifest.json
Open the pull request on GitHub
Add Sitehand setupMerged
4OptionalComing

Make hard-coded copy editable

If your words live inside components, Sitehand can propose a branch that moves them into content files. You review it and merge it.

Coming: copy conversion is built and in testing. It opens once it runs on hosted servers.

Northwind DentalHard-coded copy
src/components/Hero.astro
- <h1>Simple, honest pricing</h1>
+ <h1>{home.title}</h1>
src/content/home.json
+ { "title": "Simple, honest pricing" }
5Coming

Make your first change

Edit a page, send it for review, and publish. Your host deploys it as usual.

Coming: publishing waits on build checks from Vercel.

Northwind Dentalpricingfamily-plan
SaveSubmit for review
DraftIn reviewApprovedLive
Plan nameFamily check-up
Monthly price (£)edited · Was 2124
TaglineeditedTwo check-ups and a hygienist visit a year
Call to actionBook a visit
hero-family.webp212 KB
Live preview· build passed
Northwind DentalTreatmentsPricingTeam
Simple, honest pricing
No surprises. Cancel any time.
Essentials
£12/mo
Check-ups, x-rays and advice
Book a visit
Changed
Family check-up
£24/mo
Two check-ups and a hygienist visit a year
Book a visit
Complete
£39/mo
Check-ups, x-rays and advice
Book a visit
Writes

What Sitehand touches

Setup from the app, copy conversion and publishing are coming. Once they ship, setup and copy conversion will each write to their own branch, which will reach your main branch only when you merge it. Everyday edits will go to a change branch and reach your main branch when an approver presses Publish. Undo will write to your main branch directly.

WhenSitehand writesWhereReaches your main branch
Setup (step 3).sitehand/ (setup, schemas, manifest)A setup branchOnly when you merge its pull request on GitHub
Copy conversion (step 4)Content files, plus the components that show that copyA conversion branchOnly when you merge its pull request on GitHub
Everyday edits (step 5)Content files inside the folders you approvedA change branchWhen an approver presses Publish
UndoRestores an earlier published versionYour main branchWhen someone with publish rights presses Roll back
  • Sitehand never opens or merges pull requests for you.
  • It never deploys. Your host does.
  • Everyday edits never touch code, config or build settings.
What you need
  • A GitHub repository.
  • A site built with Astro, Next.js or Vite.
  • The site deployed on Vercel from that repository.
  • A second person to approve changes, unless you allow self-approval.
Supported stacks