Skip to main content
Site Blueprint

Content Pages

Blog, journal, docs, and learn collection pages — content discovery and rendering

February 23, 2026

Content Pages

Pages that render content from Astro content collections: blog posts, journal entries, documentation, and learning modules.

Blog & Posts (3 pages)

RouteTypeDescription
/blogStaticBlog index — paginated card grid with category filters
/blog/:slugStaticBlog post redirect (canonical at /posts/)
/posts/:slugStaticIndividual blog post with MiniGraph, related posts, tags

Content source: src/content/posts/ — Markdown files with frontmatter (title, description, pubDate, heroImage, category, tags, mood, readTime).

Features:

  • MiniGraph showing 3-level content neighborhood
  • Related posts scored by tag overlap, sorted by date
  • Category badges and tag links
  • Reading time estimate
  • Appears in search index and KnowledgeGraph

Journal (2 pages)

RouteTypeDescription
/journalStaticJournal index — reverse chronological with mood badges
/journal/:slug*StaticIndividual journal entry

Content source: src/content/journal/ — Daily engineering logs with mood tags (DEBUGGING, TRIUMPHANT, LOG, DISCOVERY).

Documentation (2 pages)

RouteTypeDescription
/docsStaticDocumentation index
/docs/:slug*StaticIndividual doc page

Content source: src/content/docs/ — 70+ files across 14 sections. Also served through the admin Docs Hub at /admin/docs-hub.

Sections: architecture, handbook, getting-started, admin, command-center, playgrounds, site, integrations, features, blueprint.

Learn (2 pages)

RouteTypeDescription
/learnStaticLearning module index
/learn/:slug*StaticIndividual learning page

Content source: src/content/learn/ — Structured learning content with progressive difficulty.

Tags & Discovery (2 pages)

RouteTypeDescription
/tagsStaticFull KnowledgeGraph visualization (Cytoscape.js)
/tag/:tagStaticPer-tag filtered graph + post list

Features:

  • 10+ layout algorithms (force, concentric, spiral, radial, clustered, grid, organic, tree, Obsidian presets)
  • Physics engine with 5 tunable parameters
  • Tag hierarchy grouping (~40 relationships)
  • Node types: Posts (blue), Tags (green), Categories (purple)

Content Collections Schema

All content collections use Zod schemas defined in src/content/config.ts:

CollectionKey Fields
poststitle, description, pubDate, heroImage, category, tags, mood
journaltitle, description, pubDate, mood, tags
docstitle, description, pubDate, section, order, tags, toc
learntitle, description, pubDate, tags
configurationstitle, description, pubDate, tags
projectstitle, description, pubDate, tags, tech
blogjournaldocslearncontentblueprint