Skip to content

Richer 8-section guides + simpler 8-pill filters (famous books first)#3

Merged
700799 merged 4 commits into
mainfrom
claude/tidy-filter-pills
May 30, 2026
Merged

Richer 8-section guides + simpler 8-pill filters (famous books first)#3
700799 merged 4 commits into
mainfrom
claude/tidy-filter-pills

Conversation

@700799

@700799 700799 commented May 30, 2026

Copy link
Copy Markdown
Owner

Two improvements

1. Fewer filter pills (8 + 8)

The browse bar had ~22 genre pills and ~50 theme pills (one per granular tag). This collapses them into 8 clean canonical categories each:

  • Genres: Tragedy · Dystopian & Sci-Fi · Coming-of-Age · Gothic & Romance · Drama · Satire & Political · Historical & Realism · Epic & Adventure
  • Themes: Power & Politics · Identity & Belonging · Morality & Justice · Love & Family · Race & Class · Dreams & Ambition · Freedom & Society · Science & Mortality

A book belongs to a bucket if it has any member tag (mapping in src/lib/filters.ts). Cards and guide pages keep their detailed tags — only the filter bar is simplified.

2. In-depth 8-section guide format

New optional BookDeepDive model (src/data/types.ts) renders a much richer guide with a sticky quick-nav:

  1. What makes it famous
  2. 📖 Plot summary — section-by-section with turning points
  3. 👥 Character analysis — role, motivation, and arc per character
  4. 💡 Themes — the big ideas, explained
  5. 🔑 Symbols & motifs
  6. ✍️ Literary analysis — style, tone, setting, devices
  7. Important quotes + 🌍 how it connects to today (2026)
  8. ✏️ Study questions (discussion + essay) and 🖋️ about the author

Books without a deep dive fall back to the existing layout, so the build stays green during rollout.

Rewritten in the new format (famous first)

1984 · Crime and Punishment · The Great Gatsby · To Kill a Mockingbird

The remaining 30 books will be rewritten in subsequent batches.

Verify

  • npm run build succeeds (39 routes export to out/)
  • Home filter bar shows 8 genre + 8 theme pills; granular tags (Postcolonial, Vignettes, …) no longer appear as pills
  • The 4 rewritten guides render all 8 sections (spot-checked: Newspeak/Eric Arthur Blair, Jazz Age, Pulitzer, "extraordinary man")

Note on "why so slow": the site is a static export served from GitHub Pages' CDN — perceived slowness is almost certainly the Actions deploy not having finished yet, not runtime hosting.

https://claude.ai/code/session_01Egnnw9v4T3ppsAQveFnijo


Generated by Claude Code

claude and others added 3 commits May 30, 2026 04:28
Filter pills: collapse ~22 granular genres and ~50 themes into 8 clean
canonical buckets each (genre + theme), matched via membership mapping in
filters.ts. Cards/guides keep their detailed tags.

Deep-dive content model: add optional BookDeepDive (what makes it famous,
chapter-by-chapter plot, character analysis, theme deep-dives, symbols &
motifs, style/devices, study questions, about-the-author). The guide page
renders the full 8-section layout with a sticky quick-nav when present, and
falls back to the legacy layout otherwise.

Rewrite the most famous titles first in the new format: 1984, Crime and
Punishment, The Great Gatsby, To Kill a Mockingbird. Remaining books to be
rolled out in batches.

https://claude.ai/code/session_01Egnnw9v4T3ppsAQveFnijo
The committed guide page references book.deepDive and the canonical filter
buckets; this adds the matching type definitions (BookDeepDive + optional
field on Book) and the 8-bucket genre/theme mapping so the branch compiles.
Adds a CI job that runs `npm ci && npm run build` on every PR so the static
export is verified before merge.
@700799 700799 marked this pull request as ready for review May 30, 2026 04:40
@700799 700799 merged commit 64e903b into main May 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants