Skip to content

v2.0.0 — Profile-aware Astro book scaffold

Choose a tag to compare

@brandon-behring brandon-behring released this 19 May 00:50

Major version bump — profile-aware architecture.

What's new

BOOK_PROFILE env var now dispatches schemas, integrations, and recipes across three profiles:

  • academic — KaTeX (36-macro library), BibTeX pipeline, 10 academic callouts + Theorem family, 7-state status frontmatter
  • tools — 8 callouts, volatility + T1-T4 source tiers, convergence dashboard
  • minimal — single-author manifesto / essay collection (uses tools schema)

Plus, profile-agnostic:

  • Three-tier Tufte layout (65/80/90ch) + left chapter-nav sidebar
  • Pre-flight content validator catches bibkey/XRef/Figure typos before they ship
  • Cloudflare Workers + Static Assets deploy via wrangler.toml
  • 11 terse-pointer recipes + 2 chapter-shape templates
  • Dual license (MIT for code, CC-BY-4.0 for content)

Reference implementations

Migration

v2.0 is for new books only. Existing books freeze on current code; v3.0 (npm package, deferred) will migrate them.

See CHANGELOG.md for full details and recipes/08-decisions-ledger.md for the 15 design decisions encoded.