Checking access...

Access Denied

This page is restricted to project administrators.

Documentation

Session 15: PDF Page Break Fixes & Prompt Toggle

Date: 2026-03-19 Focus: Fix PDF page breaks across book sizes, add show/hide prompts toggle

Removed double padding on contributor pages and TOC pages. Both page and contributorPage styles had padding: s(50, sf), effectively doubling the margin. On a 6x9" book this ate ~76pt per side, shrinking the content area and causing excessive page breaks with large white gaps.
Fixed page numbering using react-pdf's fixed prop and render callback. Previously, page numbers only appeared on the last page of multi-page contributor content. Now every page shows the correct document-wide page number.
Added minPresenceAhead on contributor headers (80pt) and prompt labels (60pt) to prevent orphaned elements at the bottom of pages. This ensures prompts always have content following them before a page break occurs.
Added explicit wrap prop on <Page> and content <View> elements for proper multi-page flow.

Added showPrompts prop to TributeBookPDF component (defaults to true for backward compatibility).
Added a "Show prompts" checkbox next to the "Download PDF" button in PDFDownloadButton.
When unchecked, italic prompt labels (e.g., "What do you admire most about [Name]?") are completely removed from the generated PDF.
Use case: Sheri is building a book for a family member where the prompts don't fit the content.

Added "Shared Links" section to Signal dashboard that displays notes.ath.how pages shared with the client.
Parsed from a new ## Shared Links table in STATE.md.
Fixed blocker link parser to support external URLs (previously only matched internal /path routes).

Created a Node.js test script (tmp/test-pdf.tsx) that generates PDFs server-side using @react-pdf/renderer's renderToFile.
Tested with C.C. Dudley's full tribute content (3 responses from "Siblings") across:
- 6x9" (Classic) -- 8 content pages, clean breaks
- 7x10" (Executive) -- proper scaling
- 8.5x11" (Full Page) -- content fills correctly
Verified prompts ON and OFF for all sizes.

Prompt toggle is UI-only -- no database column. The checkbox state lives in React component state and resets on page reload. Keeps it simple.
Page numbers use document-wide numbering -- the cover page is page 1 (hidden), so contributor content starts at page 2+. Matches reader expectations.
Notes.ath.how pages belong in notes/sites/notes-ath-how/ -- NOT in the hash-pages repo. hash-pages-demo is a public demo site.

src/components/TributeBookPDF.tsx -- removed double padding, added showPrompts prop, fixed page numbers, added minPresenceAhead
src/components/PDFDownloadButton.tsx -- added "Show prompts" checkbox toggle, passes showPrompts to PDF component
src/pages/signal.astro -- added Shared Links section, fixed external URL parsing in blockers
STATE.md -- added Session 15 work, Shared Links table, blocker for PDF fixes verification