Astro Adapter Mismatch Between SSR and SSG Modes
Astro deploy fails or pages render blank because the adapter and output mode don't match, or a route's prerender flag silently overrides the global mode. Diagnose and fix it (Astro 5/6, June 2026).
#Astro
Articles tagged with #Astro
Astro Image Optimization 2026: AVIF, Layout, Priority
The current Astro image pipeline for 2026: AVIF-first Picture, the stable responsive layout prop, the priority shortcut for LCP, and Astro 6.1 codec config most tutorials still miss.
Astro Incremental Content Update Without a Full Rebuild
Ship one article edit on a 3,000-page Astro site without rebuilding everything: Content Layer caching, on-demand routes, hash-gated CI, and per-file CDN purge. Tested patterns for June 2026.
When Astro Is the Right Choice (And When It Isn't)
An Astro 6 decision guide (June 2026): the project shapes where Astro wins, where Next.js or Hugo win instead, and a 1-day spike to confirm before you commit.
Building Category and Tag Pages in Astro 6
Build category and tag index pages in Astro 6 that scale, rank, and dodge the thin-page trap — using the Content Layer (glob + file loaders) as the data layer.
Astro Content Collections: A 30-Minute Getting-Started (Astro 6)
A focused, current walkthrough of Astro Content Collections on Astro 6: the glob() loader, content.config.ts, Zod schemas, render(entry), and the workflow that keeps a 1,000-article site maintainable.
Deploy an Astro Site to Firebase Hosting (2026)
Deploy a static Astro site to Firebase Hosting the right way: the firebase.json config, cache headers, clean URLs, and the SPA-rewrite trap that breaks your 404s.
Astro SEO Basics: Title, Meta, Canonical, Hreflang
The minimum-viable SEO setup for an Astro site: the exact head tags every page needs, the pixel limits that matter, and patterns that hold at 500+ articles.
Astro Sitemap Setup: hreflang, Exclusions, lastmod
Generate, validate, and submit sitemap.xml in Astro with @astrojs/sitemap — hreflang pairs, filter exclusions, lastmod, and what Google actually does with it (June 2026).
Astro vs Next.js for a Content Site (June 2026)
Astro 6 vs Next.js 16 for content sites: real version facts, hosting costs, a decision checklist, and the migration tax nobody warns you about.
Building a Markdown / MDX Content Site That Scales
Structure a Markdown / MDX content site to scale from 50 to 1000+ articles on Astro 6. Content Layer schema, component map, link checker, and the brace gotcha.
Deploy an Astro Site on Vercel: the 10-Minute Path (2026)
Ship Astro on Vercel with the exact Astro 5 astro.config.mjs, Node 22 pin, vercel.json cache headers, CLI commands, and DNS + SSL verification — no detours.
How to Use AI to Audit an Astro Content Site (Without Reading Every File)
A reproducible AI audit for Astro 5/6 content sites: catch duplicate slugs, missing translations, dead internal links, and draft leakage with one script wired into prebuild.
Astro Pages 404 After Deploy
Pages work in dev but 404 in prod — almost always a build.format, trailingSlash, or output-mode mismatch with the host. Copy-paste fix path.
Build a Content Site with Claude Code (2026 Workflow)
A field-tested 2026 workflow for building a bilingual Astro content site with Claude Code: exact CLAUDE.md scaffolding, plan mode, deploy-cost math, and where the agent reliably trips.