How shutootaki/bookwith works
Project Type and Purpose
• This is a full-stack, monorepo web platform called BookWith.
• Frontend: a React/Next.js reader application (“apps/reader”).
• Backend: a Python service (FastAPI-style) serving REST endpoints (“apps/api”).
• Packages: shared libraries (e.g., epubjs rendering engine, Tailwind extensions).
• Purpose: deliver an AI-powered e-book reading experience with annotations, chat, and semantic search.
File Structure
• Top level is a pnpm/Turbo monorepo:
• apps/api – the Python backend (domain-driven, layered architecture with config, domain, infrastructure, usecases, presentation).
• apps/reader – the Next.js frontend (UI components, hooks, API client, styles, workers).
• packages – reusable modules (epubjs renderer, Tailwind design tokens, internal utilities).
• supabase – database migrations/auth config.
• CI/CD workflows for frontend and backend in .github/workflows.
• Shared linting, formatting, and pre-commit hooks.
README for Additional Insights
• Describes AI Reading Assistant, Multi-Layer Memory (short, mid, long-term), Smart Annotation, Semantic Search.
• Indicates external dependencies: GPT-4/OpenAI, Google Cloud Storage, Postgres, vector database, Supabase auth.