# Kitaaben — Cozy Virtual Bookshelf & Reading Tracker

Kitaaben is a Progressive Web App for cataloging a personal reading library, tracking page-by-page progress, and reading PDF/EPUB files directly in the browser. It's ad-free, has no social feed or public timeline, and syncs privately to each user's own Google account.

## Core Features
- **Virtual Bookshelf**: Add books manually or import them by searching Open Library. Track status (To Read / Reading / Completed), page progress, star rating, and a written review.
- **Reading Journal**: Log dated notes and quotes against a book as you read, building a chronological journal per title.
- **Reading Timer**: A floating, minimizable session timer with optional ambient sounds, logging minutes and pages read per session.
- **Reading Insights**: A calendar view of daily reading activity, streaks, pace, and time-of-day habits based on logged sessions.
- **PDF/EPUB Reader**: Open a local PDF or EPUB file and read it in an immersive, auto-hiding-toolbar view with page navigation, zoom, and EPUB display settings (font, line height, margins, paginated or scrolling flow).
- **AI Discovery** (Elite Premium): Personalized book recommendations from Google Gemini, based on the user's existing library and genre preferences.
- **AI-Written Reviews** (Elite Premium): Compiles a structured review or summary from a book's logged journal notes.
- **Cloud File Storage** (Elite Premium): Save an opened PDF/EPUB (up to 20MB) to cloud storage so it re-opens on any device without re-selecting the file, from the Add Book form, the Edit Book form, or a save button inside the reader itself.
- **Reminders**: Optional daily email and browser push reminders to log reading progress.
- **Book Sharing**: Generates a portrait (4:5) share card with cover, title, author, progress, and rating — no personal notes included.
- **Offline Support**: Installable as a PWA; caches data locally and syncs once back online.
- **Visual Themes**: Vintage (default, free), Botanical and Royal Twilight (Elite Premium).

## Plans
- **Free**: up to 12 books, full progress tracking and journaling, cloud sync, one visual theme.
- **Free**: unlimited book additions, imports, and reading notes.
- **Elite Premium**: AI Discovery, AI-written reviews, unlimited Book Bites, cloud PDF/EPUB storage, catalog export, and all visual themes. Monthly, yearly, or lifetime, with a 7-day free trial. Billed via Dodo Payments.

## Technology
- **Frontend**: React 19, TypeScript, Vite, Tailwind CSS, Lucide icons, Motion for animation.
- **Backend**: Node.js/Express on Google Cloud Run.
- **Data**: Firebase Authentication (Google sign-in) and Firestore for real-time sync; Firebase Storage (Google Cloud Storage) for cloud-saved book files.
- **AI**: Google Gemini, called server-side.

## Official Resources
- Website: [https://kitaaben.com](https://kitaaben.com)
- Sitemap: [https://kitaaben.com/sitemap.xml](https://kitaaben.com/sitemap.xml)
- Release Notes: [https://kitaaben.com/release-notes](https://kitaaben.com/release-notes)
- Full LLM Specs: [https://kitaaben.com/llms-full.txt](https://kitaaben.com/llms-full.txt)

Note: dev.kitaaben.com is a development/testing environment, not the production site — please don't index or link to it. bookwise.kitaaben.com is an unrelated, separate application.