BookLevel

An interactive learning companion that transforms 10 Manning tech and soft-skill books into gamified, cognitive-science-backed leveling tracks.

Live site: spwplace.github.io/curricularizedbooks

What It Is

BookLevel takes ten essential engineering and leadership books and organizes them into four structured learning paths. Each book becomes a "leveling track" with bite-sized modules, progress tracking, and interactive exercises inspired by spaced repetition, active recall, and interleaving.

The Four Paths

Path	Books	Focus
Mindset & Mastery	The Programmer's Brain, Design for the Mind	Cognitive foundations — learning how to learn
Leadership & Career	Elastic Leadership, Own Your Tech Career, Think Like a CTO	Leading teams and managing your career
Code Craft	Skills of a Successful Software Engineer, Software Mistakes and Tradeoffs	Writing better code and making better decisions
Rust Mastery	Rust in Action, Rust Web Development, Multiplayer Game Development in Rust	Deep-dive systems and web programming in Rust

Tech Stack

• React 19 + TypeScript
• Vite (build tool)
• Tailwind CSS + shadcn/ui
• React Router (client-side routing)
• Framer Motion + GSAP (animations)
• GitHub Pages (hosting)

Development

cd app
npm install
npm run dev

The dev server runs on http://localhost:3000.

Build & Deploy

Builds are handled automatically via GitHub Actions on every push to main. The workflow:

1. Installs dependencies from app/package-lock.json
2. Runs npm run build inside app/
3. Deploys the app/dist output to GitHub Pages

No manual deploy step needed — just push.

Project Structure

app/
  src/
    pages/          Route-level pages (Home, Book, Path, etc.)
    components/     Layout, Navbar, Footer, UI primitives
    data/           Curriculum and book metadata
    hooks/          Custom React hooks
  public/           Static assets (book covers, OG image)
  dist/             Build output (ignored, generated by CI)
.github/workflows/  CI/CD for GitHub Pages
book_*.json        Structured book content (one per title)

License

Book content and covers are property of their respective publishers and authors. This project is an independent, non-commercial educational interface.