Cognivate is the complete, production source code behind a live App Store AI study companion. Students upload their course materials — PDFs, lecture slides, docs, or photos of notes — and the app automatically detects the subject and generates a personalized study environment: a dashboard, an AI tutor, quizzes, a formula/method library, a vocabulary bank, and a "work-it-out" practice workspace.

This is not a toy demo. It's a real, shipped product built as a pnpm monorepo with three apps wired together and sharing typed code:

• Web app — React + Vite
• Mobile app — React Native (Expo) for iOS & Android
• API — Express 5 backend with an AI analysis worker (Anthropic Claude)
• Shared libraries — Drizzle ORM (PostgreSQL) schema, an OpenAPI contract with generated client + Zod types, and an Anthropic client wrapper

Already built in and documented: Clerk authentication, RevenueCat in-app subscriptions, bring-your-own-key (BYOK) support, streaks & stats, custom decks, adaptive study modules, an audio/voice tutor mode, and a graph lab — all behind feature flags you can toggle on or off.

The codebase is fully typed (TypeScript throughout), heavily commented, and ships with 306 automated tests that pass on a clean install. Extensive documentation is included: START_HERE, README, DEPLOY, XCODE, and a MONETIZATION_SETUP guide walk you from local setup to the App Store.

Buy it to launch your own AI-powered education app, or as a reference architecture for a modern cross-platform product with AI, auth, and subscriptions.

• Cross-platform: iOS, Android (React Native / Expo) and web (React + Vite) from one codebase
• AI document analysis — upload PDFs, slides, docs or images; subject auto-detected
• AI tutor, auto-generated quizzes, flashcard decks, formula library & vocabulary bank
• "Work-it-out" practice workspace with adaptive difficulty
• Audio/voice tutor mode
• Clerk authentication (sign-in, sign-up, sessions)
• RevenueCat in-app subscriptions + bring-your-own-key (BYOK) option
• Streaks, stats, and gamified progress
• Express 5 API with a background AI analysis worker
• Drizzle ORM + PostgreSQL, typed OpenAPI contract with generated client & Zod validation
• Feature flags to toggle modules on/off
• Fully typed TypeScript, heavily commented, 306 automated tests
• Complete docs: setup, deploy, Xcode, and monetization guides

• Node.js 24 and pnpm
• PostgreSQL 13+ (local or hosted)
• Free-tier accounts to run the full stack: Anthropic (Claude API), Clerk (auth), RevenueCat (subscriptions), and a Google Cloud Storage bucket for uploads
• Xcode and/or Android Studio to build the mobile app
• An Apple Developer account to publish to the App Store (iOS min target 16.4)
• Basic familiarity with TypeScript / React / React Native

1. Unzip the package and open the folder in your editor.
2. Install dependencies:  pnpm install
3. Copy .env.example to .env and fill in your keys (Anthropic, Clerk, RevenueCat, Postgres, GCS). See START_HERE.md for the full checklist.
4. Push the database schema:  pnpm --filter @workspace/db db:push
5. Run the tests to confirm everything works:  pnpm -r test
6. Start the API + web app:  pnpm dev
7. For the mobile app: cd artifacts/cognivate-mobile, then npx expo run:ios (or run:android). See XCODE.md.
8. To monetize and publish, follow MONETIZATION_SETUP.md and DEPLOY.md.