How onepixelaway/frontend-textbooks works
Frontend Textbooks is an agent-oriented publishing tool that turns long-form manuscripts into designed, editable HTML books and print-ready PDFs. The main workflow is manuscript and plan input, validated book generation with theme and cover assets, browser pagination and rendering, then verification and PDF export. The README also describes source-preservation checks, responsive layouts, diagrams and feature pages, bundled typography, and aesthetic evidence. The graph reflects documented capabilities; unsampled subsystem wiring is intentionally left unspecified.
Main entry points: build-html-book.mjs HTML book builder · book-pipeline.mjs Book pipeline · browser-runtime.mjs Browser renderer · book-browser.mjs Book browser runner
Components 20
Authoring Inputs
- Manuscript
- Book plan
Book Production
- Book pipeline
scripts/book-pipeline.mjs - HTML book builder
scripts/build-html-book.mjs - Manuscript parser
scripts/lib/manuscript.mjs - Plan compiler
scripts/lib/plan-compiler.mjs - Theme registry
themes/index.mjs - Theme fonts
themes/font-assets.mjs - Cover assets
scripts/lib/cover-assets.mjs
Layout and Rendering
- HTML book
- Pagination client
scripts/lib/book-client-program.mjs - Browser renderer
scripts/lib/browser-runtime.mjs - Book browser runner
scripts/book-browser.mjs
Verification and Export
- Verification checks
scripts/lib/verification-checks.mjs - Verification profiles
scripts/lib/verification-profiles.mjs - Rendered reports
scripts/lib/rendered-report.mjs - PDF structure inspection
scripts/pdf-inspection.mjs - Print PDF
- Aesthetic evidence
scripts/lib/aesthetic-review.mjs
Other components
- Coding agent
Connections 23
- Coding agent → Manuscript: provides source
- Coding agent → Book plan: supplies plan
- Coding agent → Book pipeline: runs workflow
- Book pipeline → HTML book builder: invokes build
- HTML book builder → Manuscript parser: parses manuscript
- HTML book builder → Plan compiler: compiles plan
- HTML book builder → Theme registry: resolves theme
- HTML book builder → Theme fonts: resolves fonts
- HTML book builder → Cover assets: validates cover
- Manuscript → HTML book builder: build input
- Book plan → HTML book builder: build input
- HTML book builder → HTML book: writes HTML
- Pagination client → HTML book: provides pagination
- Book pipeline → Book browser runner: requests rendering
- Book browser runner → Browser renderer: renders pages
- Browser renderer → HTML book: loads HTML
- Book pipeline → Verification profiles: selects checks
- Book pipeline → Verification checks: runs verification
- Verification checks → Book browser runner: checks rendered pages
- Browser renderer → Rendered reports: produces evidence
- Book pipeline → Print PDF: exports PDF
- Print PDF → PDF structure inspection: inspects structure
- Rendered reports → Aesthetic evidence: supplies visual evidence