BookEqualizer - B2B Educational Reading Platform
Project Overview
BookEqualizer is a teacher-first B2B educational reading platform targeting schools and districts. The platform provides classroom management with AI-powered reading assistance and real-time text-audio synchronization.
**Target Market**: B2B Education (Schools, Districts, Educational Institutions)
**Core Value**: Teacher-first classroom management with AI-powered reading assistance
**Revenue Goal**: $100K ARR through school/district licensing
**Repository**: https://github.com/francktshibala/bookequalizer.git
Architecture
**Ultra-Simplified Stack**:
Monolithic Next.js 14.2.8 with API routes (no separate Express backend)Single PostgreSQL database with SupabaseOne Python AI service for text processingClerk authentication with classroom organizationDeployment: Vercel + Supabase onlyDevelopment Commands
```bash
npm run dev # Start Next.js development server
npm run db:push # Push database schema changes
npm run typecheck # Run TypeScript type checking
npm run lint # Run linting
```
Key Features
For Teachers (Primary Users)
**Classroom Overview Dashboard** - 20-30 students at-a-glance with reading levels and alerts**Bulk Assignment System** - Assign content to student groups efficiently **Intervention Alerts** - Immediately highlight struggling readers**Progress Analytics** - Visual dashboards showing reading improvement trends**Parent Communication** - Auto-generated progress reports**Google Books Integration** - Access to 10M+ educational titlesFor Students (Simplified Interface)
Large "Start Reading" button with minimal navigationReal-time text-audio synchronization (<50ms delay)AI-powered Q&A for comprehensionAlways-visible progress trackingWCAG 2.1 AA accessibility featuresFor Administrators
School/district usage analyticsFERPA/COPPA compliance documentationLicense management and ROI reportingDevelopment Standards
Code Quality
TypeScript strict mode enabledComprehensive error handling throughoutInput validation with ZodWCAG 2.1 AA compliance for accessibilityPerformance Targets
Page load: <2 secondsAI response: <3 secondsAudio sync delay: <50msSecurity Requirements
FERPA/COPPA compliance for student dataRole-based access controlSecure document storageInput sanitization on all user inputsImplementation Approach
Ultra-Simplified Philosophy
**What We're NOT Doing**:
Multi-agent development (ONE agent only)Separate Express backend (Next.js API routes only)Consumer B2C features Complex deployment infrastructureFancy animations or design**What We ARE Doing**:
Teacher-first B2B education platformMonolithic Next.js architecture until $100K ARRShip MVP in 4 weeks, not 8Validate with teachers before building more featuresEducational UI/UX patterns (clean, professional, boring)4-Week MVP Timeline
**Week 1: Teacher Dashboard Foundation**
Teacher authentication with Clerk (classroom organization)Classroom overview dashboard (student list, reading levels)Basic database schema for schools/classrooms/studentsGoogle Books API integration for content library**Week 2: Assignment & Content Management**
Bulk assignment system (assign books to student groups)Content upload (PDF support + Google Books)Student invitation/enrollment systemTeacher content library management**Week 3: Student Reading Experience**
Simplified student interface (large "Start Reading" button)Real-time text-audio synchronizationAI-powered Q&A systemBasic progress tracking (time spent, pages read)**Week 4: Analytics & Pilot Preparation**
Teacher progress analytics dashboardIntervention alerts for struggling readersFERPA compliance documentationDeploy pilot version for 3 teacher validation callsUI/UX Design System
**Colors**: Navy blue (#1e40af) + Forest green (#059669)
**Typography**: Large, sans-serif fonts for accessibility
**Layout**: Grid-based, mobile-first (teachers use iPads)
**Interactions**: Large touch targets, minimal animations
**Priority**: Teacher workflow efficiency over visual appeal
B2B Sales Context
Key Decision Makers
1. **Superintendent** - Final authority for $15K+ purchases
2. **Curriculum Director** - Educational alignment & standards compliance
3. **Technology Director** - Technical feasibility & security
Pricing Model
School License: $10K-15K/yearDistrict License: $50K-100K/year Pilot Program: 3-month free with full supportTarget Pain Points
Reading intervention costs ($10K-100K/year per school)Teacher training requirements (80+ hours for new tools)40% of 4th graders can't read at basic levelState compliance mandatesSuccess Metrics
Week 4 MVP Goals
3 teacher validation calls completedTeacher dashboard functionalStudent reading experience workingFERPA compliance documentation ready30-Day Post-MVP
3 pilot schools contracted ($30K ARR)50 active teacher accounts500 students using weekly80% teacher satisfaction (reduces prep time)Instructions for AI Agents
When working on this codebase:
1. **Always prioritize teacher workflow efficiency** over visual appeal or complex features
2. **Use Next.js API routes** for all backend logic - do not create separate backend services
3. **Follow the monolithic architecture** - keep everything in the Next.js application
4. **Implement comprehensive error handling** and input validation with Zod
5. **Ensure WCAG 2.1 AA compliance** for all UI components
6. **Focus on performance targets** - page loads <2s, AI responses <3s, audio sync <50ms
7. **Document FERPA/COPPA compliance** considerations for any student data handling
8. **Use TypeScript strict mode** and maintain type safety throughout
9. **Keep UI simple and professional** - educational design patterns, large touch targets
10. **Validate features with teachers** before expanding scope
When asked to implement new features, always consider:
Does this help teachers manage 20-30 students efficiently?Does this align with B2B school/district buying criteria?Does this maintain our simplified architecture?Does this meet accessibility and security requirements?