Web · Workflow
Workflow — for the PM
How to operate the SuperStories website system day-to-day. Assumes the setup is complete: the Astro + Sveltia template exists and a client site is in a repo. How to onboard a VA and the client is on the onboarding page. Why this is structurally different from WordPress, Webflow, or a templated builder is on the comparison page.
The first site we build is markandreas.com. It is the trial that hardens this page.
What we build, in one line
A fast static website with a simple editor behind it, so the client changes their own copy without touching code. No WordPress, no Webflow. The result loads fast (good for SEO and visitors), is safe (little to attack), and is cheap to run. The same setup is reused for every coach site. markandreas.com is the first.
The four parts you need to understand (not build)
| Part | In plain terms | Who touches it |
|---|---|---|
| Astro | The site builder. Turns content + design into ready-made, fast pages. | Peter (build) |
| Sveltia | The editor. A web page where the client edits text and photos, no code. | Client (daily), you (explain) |
| GitHub | The vault. Code and content both live here, with full history. The single source of truth. | Automatic |
| Coolify | The server. Publishes the site automatically whenever something changes. | You (set up once) |
And the tools around it that make it a system, not just a site:
- GHL handles leads: the contact form, the follow-up, the calendar. This is the CRM. Not Airtable. One CRM, and it is GHL.
- Umami shows how many visitors there are and where they come from.
- Google Search Console (GSC) shows which search terms bring people in.
- Google Business Profile (GBP) is the Google business listing and the reviews. We set this up ourselves now, no external party.
The mental model
This is the whole system in one picture. When the client edits a text, this happens, automatically:
Client edits in Sveltia → GitHub saves it → Coolify rebuilds → live in about a minute.
Nobody touches code. The client types in a form and clicks save. The rest runs by itself. Your job is to turn this on once and then explain it to the client.
The golden rule. You and Peter do not write client copy. The client owns their own text in Sveltia. That is exactly why we chose this setup. When a copy question comes in, the answer is: "that is yours to do in the editor, here is how."
Who does what
| Person | Role on a website project |
|---|---|
| Peter | Strategy, positioning, SEO basis, and building the Astro + Sveltia structure. Hands you a working site in GitHub. |
| You (PM) | Take the site live, connect the tools, test end-to-end, onboard the client. You guard delivery. You do not write copy. |
| The client | Owns all text and photos in Sveltia. The editor-in-chief of their own site. |
| I&Y | Sets up GHL (form, CRM, calendar). 2 to 3 hours, scheduled with you. |
| You / a VA | Google Business Profile. We do this in-house now, no external party. |
Your role: now you, later a VA
Making a site costs little time: about 2 hours once the template exists. One hour of conversation about positioning and content, one hour building in Claude Code. That is the creation, and Peter does it. Your work is the delivery: take it live, connect the tools, test, and hand it over cleanly.
This first time you do more than execute. You prove and sharpen the process. Write down what was unclear while you run it. Those notes improve this page and become the instruction for the VA.
Why you and not an external hire yet: the first time is process design and judgement, with an important client. That belongs in-house. Once the process holds, it flips: you train a VA from this page and you guard quality. You become the owner of the recipe, not the eternal cook. Your real output here is a sharp runbook plus a VA who can run it, not a single delivered site.
What you need before you start
Ask Peter for this access. Without it you cannot start.
- Access to the GitHub repo of the site (the vault).
- Access to Coolify (the server).
- The Sveltia admin link (usually
/admin) and how login works. - Access to the domain (DNS settings).
- Contact for I&Y (GHL).
- Your own GitHub account (free). The client needs one too, to log in to the editor.
The runbook
Work top to bottom. Expect half a day to a day once you have access. Each phase names who runs it and roughly how long.
Phase 0 — Understand the parts (about 30 min, you)
Re-read the mental model. Open the Sveltia admin link Peter gives you and click around without saving, so you see what the client will see. Goal: you understand the rhythm edit → save → live before you switch anything on.
Phase 1 — Take the site live on Coolify (about 30 min, you with Peter)
- Peter delivers the working site in the GitHub repo. In Coolify, connect that repo to a new project.
- Coolify builds the site and gives you a temporary test link. Open it, confirm every page loads.
- Point the domain at Coolify (DNS at the registrar) and turn on SSL (the padlock). Coolify issues the certificate.
The first connection you do together with Peter over screen share. After that you can do it alone for the next site.
Phase 2 — Turn editing on and test it end-to-end (about 45 min, you)
The editor (Sveltia) is already wired to the repo by Peter. Your task is to prove the whole chain works:
- Log in to the admin link with your GitHub account.
- Change one line of text on a test page and click save / publish.
- Check in GitHub that the change lands, and in Coolify that the site rebuilds.
- Open the live site and confirm your change is there after about a minute.
- Put it back. Now you know the loop is closed.
Phase 3 — Connect the tools (about 2 hours, partly waiting on others)
- GHL — schedule a session with I&Y. They wire the contact form to the CRM and the calendar. Then check yourself: fill in the form on the site and confirm the lead arrives in GHL, including the "How did you find me?" field.
- Umami — Peter gives you a small script or a Coolify button. Place it, confirm a visit shows up in the Umami dashboard.
- Google Search Console — add the site, confirm ownership, submit the
sitemap.xml. This is the feedback on whether the SEO lands. - Google Business Profile — we set this up ourselves. Create or claim the profile, pick the right category, link the site, add photos, list the free intro as a service. Make name, address, and phone exactly equal to the site footer, and verify the profile.
Phase 4 — Ready for launch (about 45 min, you)
- The review panel and annotation script are removed from the site (Peter confirms; it is a review tool, not for production).
sitemap.xmlandrobots.txtare online and correct.- Every page has its own title, meta description, and JSON-LD schema (Peter builds these; you confirm they are present).
llms.txtis on the root.- All images have alt text and the site loads fast on mobile.
- The form works and the lead lands in GHL.
- SSL (the padlock) is on for the real domain.
Phase 5 — Onboard the client (about 30 min, you)
This is the most important handover. After it, the client owns their own text and you are no longer called for copy.
- Create the client a login for the editor (their free GitHub account, one-time).
- Record a short Loom (about 5 min): log in → change a text → save → check the live site.
- Let them do it once themselves while you watch. After that they can.
How editing works (to show the client)
The editor shows clean fields per page: a heading, a subhead, text blocks, a photo, a button. The client changes what is in the fields and clicks save. They never see code.
- Text — click a field, type, save.
- Photos — upload in the image field; the editor places it.
- See it live — after saving it takes about a minute for the site to rebuild. Wait, then refresh.
- Made a mistake? Everything is in GitHub with a history. Nothing is truly lost; an earlier version is always recoverable. When in doubt: Peter.
After: the monthly look
Once the site runs, there is one recurring ritual of 30 minutes a month. It answers: who is the client, where do they come from, and what creates movement. The full setup is the MVRP in the client's coach-setup-manual. In short, look at: enquiries this month, top sources (the "how did you find me" field plus Umami), and which one or two activities created movement. Do more of that the next month.
When something looks broken
- Change not live? Wait 2 minutes. Check in Coolify whether the build finished. Hard refresh (Cmd/Ctrl + Shift + R).
- Editor will not load? Check that you are logged in with the right GitHub account. Otherwise Peter.
- Lead not arriving in GHL? I&Y, that is their connection.
- Anything with code, build errors, or you do not know? Do not poke in the code. Peter.
Rule of thumb. Editing through the editor and setting up the tools: your work. Touching the code: never. That is the line. Hold it and little can go wrong.
What we don't do
- We don't write the client's copy for them. The editor exists so they own it.
- We don't run two CRMs. GHL is the CRM, Airtable is not.
- We don't deploy with the review tools still on. They come off before launch.
- We don't go live without the lead loop tested. A site that does not capture an enquiry is a brochure.
- We don't hand the first build of a new site to a VA. The first one proves the process; a VA runs the clones.