01 · What You Get

← Docs home · For a prospective author deciding whether to run their book through bookSHelf.

The one-line pitch

Send us an open textbook. We hand it back as a print-grade, interactive web edition — with worked solutions, animated figures, narrated video openers, slide decks, and a fully accessible EPUB — and we host it for you.

bookSHelf is not a PDF-to-HTML converter. It is an editorial pipeline: every section is remastered for clarity, renumbered consistently, given worked solutions, math-checked, and laid out in a typographic theme that reads like a published book — then enriched with media that a static textbook can’t carry.

Before → After

Raw open textbook	bookSHelf Student Enhanced Edition
Flat PDF or bare OpenStax HTML	Print-grade page, warm parchment canvas, editorial typography
Static equations (sometimes broken MathML)	Clean in-browser math (KaTeX / MathJax), delimiter-checked
End-of-chapter answers only (or none)	Per-problem worked solutions in collapsible blocks
Static figure images	Animated figures (silent looping MP4 pairs with a scrubber) where motion teaches
Wall of text	Try-It-Now practice, Context Pause and Insight Note callouts
No video	Voice-narrated, multi-scene section openers built with Manim
No slides	Slidev decks per section, exportable to editable + rasterised PowerPoint
Inaccessible	Dyslexia font, font-resize, dark mode, read-aloud, screen-reader landmarks, EPUB with valid math
You host it	Hosted on Cloudflare’s edge, instant deploys

The feature set (what ships on a page)

These are the features genuinely present on published pages today — verified against the live HTML, not aspirational:

Reading & study

Print-grade editorial layout — the kami + Wedgwood Blue theme; warm canvas, structured definition blocks, figure captions.
In-browser math — KaTeX (Calculus) or MathJax (Stats / Finite Math), rendered client-side; delimiters are machine-checked in the pipeline.
Worked solutions — every Problem-Set problem gets a <details> block with a full worked solution, splice-verified to match the problem count.
Try-It-Now blocks, Guided Practice, Examples — inline practice with reveal-on-click solutions.
Context Pause / Insight Note callouts — editorial asides that explain the why, not just the how.
Learning Objectives, Section Summary, Key-Terms glossary, Appendix — full textbook scaffolding, consistently numbered (Chapter.Section.N).

Media

Animated figures — silent, dual-theme (light/dark) MP4 loops with a ping-pong scrubber, used where motion carries the idea (secant→tangent, transformations, sampling). Authored in Manim.
Narrated section-opener videos — multi-scene, voice-narrated explainers (Manim + neural TTS), embedded at the top of a section.
Curated tutorial videos — a per-section Videos menu of vetted YouTube links, generated from the section’s own topics.
Slide decks — a Slidev deck per section (“Present” button), exportable to both an editable PPTX (native PowerPoint shapes + equations) and a delivery-grade rasterised PPTX with embedded autoplay video.

Accessibility & portability

Accessibility track — OpenDyslexic / Atkinson Hyperlegible / Lexend fonts, font-size control, dark mode, screen-reader landmarks and ARIA labels (axe-core gated), and a read-aloud stack that speaks math correctly (Speech Rule Engine → MathSpeak, neural TTS voices).
EPUB edition — a validated EPUB build per chapter (KaTeX server-side rendered so the math survives offline; ACE-audited). Chapter 3 of Calculus passes ACE with 0 critical / 0 serious / 0 moderate.
Save offline / page search / language translate — built into the page chrome.

Optional integrations

AI study tutor — an in-page chat backed by a Cloudflare Function (/api/chat) with per-day rate limiting in D1. Bring-your-own Ollama endpoint; no vendor lock-in.
raSHio tool callouts — where a section traditionally leaned on a TI calculator, it can instead link the author’s free raSHio web tools, with a recorded walkthrough.

Proof: the live catalog

Three open textbooks have been run through the pipeline and published as one editorial collection (project bookshelf on Cloudflare Pages):

Course	Source	Coverage
Applied Finite Math	Sekhon (CC BY-NC-SA)	All 8 chapters published — the most complete
Calculus Volume 1	OpenStax (CC BY)	~12 sections live + Slidev decks; in progress
Introduction to Statistics	OpenIntro (CC BY-SA)	Chapter 8 + Chapter 1 previews; in progress

Landing experience: a curated collection home (docs/index.html), an author bio (about.html), and a full source-and-tooling credits page (credits.html).

Licensing & provenance

All source texts are open-licensed (CC BY / CC BY-NC-SA / CC BY-SA) and every course carries a generated attribution.html page crediting the original authors and the exact license.
The enhancement layer (layout, solutions, animations, videos, decks) is the curator’s work on top of those sources.
Author’s note: Curated by Steven Huff, after OpenStax and OpenIntro.

⚠️ Compatibility caveat for prospective authors: a CC BY-NC source (non-commercial) constrains how the enhanced edition may be distributed if the service is paid. Confirm the source license is compatible with your intended distribution before committing a book to the pipeline.

Want to run your book through it?

The mechanics are in the runbook — most authors care about three things:

Source in → Content Pipeline (scrape, PDF, or pre-extracted OpenStax/OpenIntro).
Enhancement → figures, videos, decks (pages 04–06).
Published & hosted → Publishing & Deploy.

Ready to start? The intake questionnaire — by email or web form — is on 11 · Client Intake & Questionnaire. It captures your source, license, the enhancements you want, and the gaps you want filled.

For how it all fits together, see Architecture.