src/pages/ AGENTS.md

Generated: 2026-03-30 Commit: c93779d Branch: main

OVERVIEW

Astro file-based routing. 9 files with [lang]/ mirrors for i18n. Handles static and dynamic routes.

STRUCTURE

src/pages/
├── index.astro            # Homepage (post list, featured series)
├── post/[...slug].astro   # Dynamic post pages
├── archive.astro          # Archive page
├── categories.astro       # Category listing
├── tags.astro             # Tag listing
├── series/[seriesSlug].astro  # Featured series pages
├── [lang]/                # i18n mirrors (8 files)
└── rss.xml.ts             # RSS feed generation

WHERE TO LOOK

Task	Location	Notes
Homepage	`index.astro`	Post list, featured series, pagination
Post pages	`post/[...slug].astro`	Dynamic routes, markdown rendering
Taxonomy pages	`archive.astro`, `categories.astro`, `tags.astro`	Filtered post lists
Series pages	`series/[seriesSlug].astro`	Featured series content
i18n routes	`[lang]/`	Locale-specific versions
RSS	`rss.xml.ts`	Atom feed with full content

CONVENTIONS

Static generation: All pages use getStaticPaths()
Locale handling: Default locale no URL prefix, others use /<locale>/
Thin wrappers: i18n pages delegate to default locale components
SEO: Proper meta tags, canonical URLs, hreflang
Prefetching: All links prefetched (prefetch:)
Error handling: Custom 404 page, graceful fallbacks

ANTI-PATTERNS (THIS MODULE)

Client-side routing: Use Astro’s static generation
Missing i18n: All public pages must have locale variants
Large data passing: Don’t pass body as prop (serialize instead)
Missing meta tags: Every page needs SEO metadata
Over-fetching: Only fetch what’s needed for static generation
Hardcoded URLs: Use Astro.site for canonical URLs

NOTES

Dynamic routes use getStaticPaths() for static generation
i18n pages are thin wrappers calling getLocaleStaticPaths()
Post pages use src/components/post/ components
Category/tag pages use src/lib/content/ for filtering
RSS feed includes full post content (HTML)