Classroom
Free, simple, low-bandwidth PWA and responsive dashboard for Ugandan schools, teachers, parents and students (nursery to S6). Built on faith. Strengthened at home. Learning together.
Status: Phase 1 (MVP) built and tested locally. Not deployed. See docs/phase-1-summary.md.
Quick start
corepack enable && pnpm install
scripts/dev-db.sh start # disposable Postgres on :54329 (or: docker compose up -d postgres)
pnpm --filter @classroom/web seed # taxonomy + 4 sample lessons + draft devotion plan
cd apps/web && ALLOW_DRAFT_DEVOTIONS=1 pnpm dev # http://localhost:5173
Login codes are printed in the server console in dev (no SMS is sent). Run scripts/e2e.sh for the full acceptance script and pnpm test for unit and integration tests.
Layout
| Path | What |
|---|
apps/web | SvelteKit app: PWA, parent/student/teacher/admin screens, API |
packages/core | permissions (can()), join codes, scheduling, notification rules |
packages/db | Drizzle schema, migrations, row-level security |
packages/content | lesson format, validator, release gate, quiz marking |
content/ | original lessons and the taxonomy |
tools/ingest | verdict-gated, robots-aware fetcher (NCDC test-only) |
docs/ | audit, architecture, ERD, API draft, design system, decisions |
Docs
Source audit · Plan · Architecture · ERD · Design system · API · Content authoring · Licensing checklist · Gaps report · Decisions
