Real-World Production Patterns
January 5, 2025 2 min read
By Alex Morgan
astro pattern web
Real-World Production Patterns (Used in Practice)
Pattern 1: Markdown-Only (Most Common)
Used by:
- Developer blogs
- Documentation sites
- OSS(Open Source Software) projects
- Marketing microsites
Architecture
Astro
├─ src/content/blog/*.md
├─ src/pages/[slug].astro
└─ Static hosting (Vercel / Netlify)
Why teams choose it
- Minimal infra
- No CMS overhead
- Blazing fast
- Easy maintenance
🚨 Breaks down when:
- Non-devs need to edit
- Content volume explodes
Pattern 2: CMS-Only (Editorial Teams)
Used by:
- Media companies
- Large marketing teams
- Product documentation
- Multi-language sites
Architecture
Sanity / Contentful
↓
Astro
↓
Static + SSR pages
Benefits
- Editors control content
- Live previews
- Scheduling
- Localization
🚨 Downsides
- Build times increase
- CMS outages affect content
- Monthly cost
Pattern 3: Hybrid (Most Professional Teams)
This is the most common real-world setup
What lives in Markdown
- Blog posts
- Docs
- Legal pages
- Long-form content
What lives in CMS
- Homepage
- Pricing
- Product features
- Testimonials
- SEO blocks
Architecture
Markdown (Git)
↓
Astro
↑
CMS (Sanity)
Why this works
- Editors manage marketing
- Devs manage content-heavy pages
- Clear separation of concerns
Pattern 4: CMS → Markdown Sync (Advanced)
Used by:
- Large teams
- Regulated industries
- Git-first workflows
Flow
CMS → Export → Markdown → Git → Astro
Benefits:
- Git history
- Offline builds
- Rollbacks
Cost:
- Custom tooling
- Maintenance overhead
Pattern 5: Runtime CMS + Static Markdown
Used when:
- Some pages must be dynamic
- Previews required
- Personalization exists
Static Markdown pages
Dynamic CMS pages (SSR)
Astro handles this well with per-route rendering modes.
Decision Matrix (Quick)
| Scenario | Best Choice |
|---|---|
| Dev blog | Markdown |
| OSS(Open Source Software) docs | Markdown |
| Marketing site | CMS |
| Startup homepage | CMS |
| SaaS docs + blog | Hybrid |
| News site | CMS |
| Personal site | Markdown |
Final Mental Model
Markdown is content-as-code
CMS is content-as-data
Astro supports both because real projects need both.