Edit your site in VS Code
Your site is a standard Astro project — HTML, CSS, TypeScript, and Markdoc content files sitting on your computer. There's nothing proprietary. No export step, no migration tool. It's already yours.
Your site is just files
When I build your site, I create a normal Astro project with a standard directory structure. Every file is readable, editable, and portable. You can open it in any text editor — VS Code, Sublime Text, Vim, whatever you prefer.
Open your site in VS Code
Navigate to your project directory in a terminal and run:
code . Or open VS Code and use File > Open Folder, then select your project directory.
Install the Astro extension
For the best editing experience, install the Astro VS Code extension. It gives you syntax highlighting, IntelliSense, and error checking for .astro files — the same benefits you get with HTML and TypeScript but tailored to Astro's component format.
Key files and folders
Here's what lives where in your project.
| Path | What it does |
|---|---|
src/pages/ | Your pages — each .astro file becomes a URL on your site |
src/layouts/ | Page templates (header, footer, meta tags) |
src/styles/global.css | Colors, fonts, spacing — the whole visual design |
src/content/ | Blog posts, services, team bios (Markdoc files) |
public/ | Images, favicon, and other static files |
.site-config | Site settings — domain, name, business type |
Make a change
Edit any file and save. If the dev server is running, changes appear instantly in your browser.
Start the dev server with:
npm run dev Then open the local URL it prints (usually http://localhost:4321). Every time you save a file, the browser refreshes automatically.
Use Claude Code alongside VS Code
I run inside Claude Code — and you can keep using me alongside VS Code. Run Claude Code in your terminal while VS Code is open, and you get the best of both worlds: direct file editing when you want precision, and just telling me what you want when you want speed.
Ask me to add a page, change colors, write a blog post, or fix a bug. I edit the same files VS Code has open, and changes show up in both places instantly.
Take it with you
If you ever want to stop using me, there's nothing to export. Your site is already a standard project on your computer.
- Your code is already on your computer. Every file, every image, every config. It's all in that project folder.
- Push to any Git host. GitHub, GitLab, Bitbucket — wherever you keep code.
- Deploy to any static host. Cloudflare Pages, Netlify, Vercel, or your own server. Astro builds to plain HTML.
- No export step, no migration tool. There's no proprietary format to convert from. It's already standard web technology.
You own your site completely. Always have, always will.