Venture Studio · Guided Apprenticeships · Agentic Marketing Agency

The Log · Lesson · 9 min read

Lesson · Tech Stacks

Why I Build Every Website on Astro (and Ditched Squarespace)

The framework you build on is a quiet decision that makes every later decision easier or harder: speed, SEO, getting cited by AI, the monthly bill. Here's why I pick Astro every time, in plain English, from someone who is not an engineer.

The whole thing in one breath

A website's framework is the foundation everything else sits on. I build on Astro because it ships almost no code to the visitor, so pages load instantly, Google indexes them, and AI can cite them. It's free and open-source, an AI agent finds it easy to work in, and you can still add rich interactive bits exactly where you want them. We moved thecouplesummit.org off a $40 a month Squarespace plan onto a $0 a month Astro and Cloudflare build. Same site, faster, basically free.

When I started building and publishing websites with AI, the first real fork in the road wasn't "what should it look like." It was "what do I build it on?" That choice, the framework, is invisible to your visitors, but it decides almost everything that matters later: how fast the site is, whether Google ranks it, whether ChatGPT quotes it, and how big the bill gets.

I tried the obvious things first. I'm a founder and marketer, not an engineer, so I reached for the website builders everyone reaches for. They work until they don't. They're slow, they lock you in, and they charge you every single month forever. So I went looking for what the people who actually build the internet use. The answer, over and over, was Astro.

⚑ Hot take: a website builder rents you your own site

Squarespace, Wix, and the rest sell you "easy," then charge you every month to keep the thing you made online, gating features and nudging the price up while you have nowhere to go. A framework like Astro is yours. You build it once, you own the files, and nobody can hike the rent on a site you control.

Explain like I'm 5 What's a website framework?
It's the starter kit your website is built from, the foundation and frame of a house before you decorate it. You don't see it, but it decides how sturdy and fast the house is. "Astro" is one such kit. "Squarespace" is a different, all-in-one one that charges rent.

What Astro actually is (and why it wins)

Astro is a free, open-source tool for building websites. Its one big idea is almost boringly simple: ship as little code to the visitor as possible.

Explain like I'm 10 Why does 'less code shipped' matter?
Every website sends files to the visitor's browser. Most builders send a huge pile of JavaScript even for a plain page, so it loads slowly and is harder for software to read. Astro sends mostly plain HTML instead: the lightweight stuff browsers, Google, and AI all read effortlessly. Less to download means faster pages and cleaner pages.

That single decision cascades into the four things I care about most as a marketer:

  • Speed. Pages are mostly plain HTML, so they load almost instantly. Fast pages keep visitors and rank better.
  • SEO and AI-readability. Because the content is right there in clean HTML, not assembled by code after the fact, Google indexes it easily and AI engines can read and cite it. Answer Engine Optimization gets much easier when the page is genuinely simple underneath.
  • Cost. Astro builds static-ish files that any host can serve cheaply, including Cloudflare's free plan, where hosting is $0.
  • Forgiving for AI. The file layout is clean and predictable, so an AI coding agent like Claude Code rarely gets confused working in it. That matters a lot when the AI is doing the building.

One more thing people don't expect: you can run a real, custom content system on Astro, including a simple markdown-file-based CMS, so you (or your AI) write posts as plain text files and Astro turns them into fast pages. No bloated admin panel, no monthly CMS fee. This very blog works that way.

Hydrated islands, in plain English

Here's the objection I always hear. "Okay, a fast plain-HTML page is great for Google and AI, but I want a nice site. I want the search box, the slider, the interactive thing. Don't I have to give up speed to get delight?"

No. And this is the real reason Astro is special. It lets you have both, and the concept that makes it possible is called islands.

Explain like I'm 5 What are hydrated islands?
Picture your page as a calm sea of fast, static content. Most of it just sits there and loads instantly. But here and there you drop in an "island," a small interactive piece like a search box or a photo carousel. Only those islands get the heavier interactive code ("hydration"). The sea around them stays light and fast. So the page is mostly instant, with pockets of delight exactly where you want them.
your-page · mostly static HTML, loads instantly SEARCH BOX island · interactive IMAGE CAROUSEL island · interactive
An Astro page is static by default. The grey content loads instantly. The orange islands (a search box, an image carousel) are the only parts that load interactive code. Speed everywhere, richness where it counts.

Most website builders do the opposite. They make the whole page heavy and interactive even when 95% of it is just text sitting still. You pay the speed tax on the entire page to get interactivity on one corner of it. Astro flips that. Static is the default, interactivity is the exception you opt into. That's why you don't have to choose between "fast and citable" and "delightful." You get both.

Astro vs Next.js, the honest comparison

If you've searched around, you've hit Next.js. It's the other big name, and it's genuinely excellent. So which one?

Short version: Next.js is built for applications, software with lots of moving, interactive parts (a dashboard, a social network, a SaaS product). Astro is built for content and marketing sites, blogs, landing pages, directories, business sites, where the job is to load fast and be found. They're both good. They're good at different jobs.

  Astro Next.js
Default JavaScript shipped Zero by default. Plain HTML, opt into interactivity Ships a JavaScript runtime by default
Learning curve Gentle, close to plain HTML Steeper. React knowledge expected
Best for Content and marketing sites, blogs, directories Complex, highly interactive web apps
SEO out of the box Excellent. Clean HTML, fast by default Good, but needs more care to stay light
Hosting cost on Cloudflare $0 on the free plan, trivially $0 possible, with more configuration

To be fair to Next.js: if you're building actual software, a product with logins, live data, and heavy interactivity, its power earns its complexity. But most of us, most of the time, are publishing pages. We want a fast site Google ranks and AI cites, for free, that an AI agent can build without tripping over itself. For that job, Astro wins, and it's not especially close.

◆ The rule I use

Building a website (content, marketing, blog, directory)? Astro. Building an app (dashboard, product, lots of live interactivity)? Next.js is fair game. When in doubt, you're probably building a website, so start with Astro.

Proof: this works, and you can switch to it

I don't just recommend Astro. I run on it. Two live examples:

  • max-ship.com, the site you're reading right now. Astro and Cloudflare. Fast, citable, about $0 to host.
  • thecouplesummit.org, a content-heavy site with a real blog, also Astro and Cloudflare.

The Couple Summit one is the proof that matters most, because it wasn't a fresh start. It was a switch. That site used to live on Squarespace at $40 a month. We moved it onto an Astro and Cloudflare build paying $0 a month for hosting. Same site, faster pages, and the bill collapsed to basically the price of the domain.

  • $40old · Squarespace / mo
  • $0new · Cloudflare host / mo
  • 2live sites on Astro
  • MITfree · open-source

▲ You're not stuck

The lesson of Couple Summit: you can not only start on Astro, you can migrate to it from an expensive builder and come out faster and cheaper. If you're paying monthly rent for a slow site right now, that's a switch you can make, not a sunk cost you're trapped in.

How to start (or switch) without being technical

You don't write Astro by hand. You describe what you want and let an AI coding agent set it up, build it, and deploy it. Open Claude Code in an empty folder and paste this:

⌘ Paste this into Claude Code to scaffold an Astro site

Set up a new Astro site for [describe my business in one sentence], optimized for speed and SEO, and ready to deploy to Cloudflare on its free plan.

Please:
1. Create a clean Astro project with Home, About, Services, Contact, and a Blog section.
2. Use a simple markdown-file-based setup for the blog so I can write posts as plain text.
3. Keep pages static and fast by default. Only add interactive "islands" where they're actually needed.
4. Add basic SEO and schema markup so AI engines can cite the pages.
Explain each choice you make in plain English as you go, and assume I'm not a developer.


End by asking me one question: "Which parts of this feel most uncertain — want me to explain them, or should I just build it for you?"

From there, deploying is one command your AI runs for you. If you want the full step-by-step (mapping the site, connecting Cloudflare, going live), that's the companion guide: how to build and publish a website with AI. Once it's live, the next two levers are getting cited by ChatGPT and seeing what visitors actually do with PostHog. If you get stuck choosing or setting it up, reach out. I'm always happy to help.

Where Astro fits in the stack

Astro is the framework (what the site is built with). Cloudflare is the host (where it lives). They pair perfectly. Astro produces light, fast files, and Cloudflare serves them free on the network that runs a fifth of the web.

References

  1. Astro, Build fast websites faster · astro.build · 2026
  2. Astro Docs, Why Astro plus Islands Architecture · docs.astro.build · 2026
  3. How to Build and Publish a Website With AI · MaxShip · 2026
  4. Why I Build on Cloudflare, Not Vercel · MaxShip · 2026
  5. Answer Engine Optimization: The Exact Format ChatGPT Cites · MaxShip · 2026