State
Compact state records for the books section.
State
Registry
| Field | Value |
|---|---|
section | books |
owner | books-section |
status | active |
updated | 2026-03-16 |
Current Cycle
| Field | Value |
|---|---|
phase | books-01 |
plan | books-01-a |
focus | keep the cleaner two-page reader, but make every illustrated page use the same fixed image frame shape as the placeholder state so art stays visually consistent and text always begins beneath it |
constraint | planning for books work lives in these docs, aligned with the real publishing pipeline |
Next Queue
| Priority | Action | Type |
|---|---|---|
1 | replace the built-in TOC with a real collapsed custom panel and restore two-page spreads on wide screens | reader-ux |
2 | keep every page on one consistent image slot shape and allow cropping instead of special-case image layouts | page-shell |
3 | refine chapter metadata and opener styling now that the source and EPUB structure are formalized | structure-polish |
References
| Id | Path | Purpose |
|---|---|---|
books-root | books/mordreds_tale/ | authored source of truth |
home-page | apps/portfolio/app/page.tsx | primary site reading entry |
reader-embed | apps/portfolio/components/books/BookReaderEmbed.tsx | embedded reader surface |
viewer | apps/portfolio/components/books/EpubViewer.tsx | EPUB runtime and loading path |
epub-builder | packages/repub-builder/src/epub.ts | EPUB image rewrite and chapter packaging |
books-structure-doc | apps/portfolio/content/docs/books/book-structure.mdx | formal source and EPUB structure rules |
book-output | apps/portfolio/public/books/ | generated reading artifacts |
front-page-reader | apps/portfolio/components/home/FeaturedBookExperience.tsx | user-triggered reader mount path |
Human Input
| Trigger | Action |
|---|---|
| publishing flow changes | update current cycle and references first |
| reader UX changes | record the new focus before implementation |
| new requirements appear | add them in the books docs planning pages before execution |