Open Source Bible School LMS — we need your help (React, FastAPI, Supabase)

#opensource #react #fastapi #supabase

Why I’m writing this

Small Bible schools, home groups, and volunteer-run training programs still run classes on paper, messengers, and spreadsheets. Big LMS products are either too expensive or too heavy for a team that has no DevOps and no budget.

Bible School LMS is a free, open-source learning platform built for that reality: tens to low hundreds of users, not “enterprise 10k seats”.

We’re on GitHub (MIT) and we’d love contributors — code, UI, docs, accessibility, and ideas.

What it does today

Courses → modules → chapters with a TipTap rich editor (text, images, YouTube, callouts, audio).
Quizzes — multiple choice, true/false, short answer, essay; teacher grading and extra attempts when needed.
Assignments + gradebook, progress, certificates (with approval flow).
Teacher & admin tools: cohorts, calendar, announcements, analytics, soft-delete / restore, CSV export.
Auth via Supabase (email/password + Google).
Deploy: Vercel (static frontend + serverless FastAPI backend), Postgres on Supabase with RLS.

Live app: biblie-school-frontend

Roadmap: in the repo → ROADMAP.md

How to contribute: CONTRIBUTING.md

Stack (if you like concrete tech)

Layer	Tech
UI	React 18, TypeScript, Vite, Tailwind, shadcn/ui, TipTap, Radix
API	Python 3.12, FastAPI, SQLAlchemy 2, Pydantic 2
Data	PostgreSQL (Supabase), migrations in `supabase/migrations/*.sql`
CI	GitHub Actions — lint, typecheck, tests (backend + frontend)

We keep conventional commits, no Docker in the project by design, and we care about types (mypy + strict TypeScript) and a clean codebase.

How you can help (no need to be a “10×” developer)

Good first issues — filter by good first issue on GitHub.
UI/UX — especially accessibility and a calmer, “editorial” reading experience.
Docs — setup stories from real machines (Windows / macOS / Linux) help a lot.
i18n — the product UI is largely Russian today; if you care about internationalization, that’s a meaningful roadmap area.

Open a draft PR, ask in an issue, or fork and experiment — we’re building in public and want this to stay approachable for nonprofits and volunteers.