Ekklesia
Ekklesia is an open, modular church technology platform for composing backend capabilities into independently developed dashboards, websites, mobile apps, kiosks, displays, and other surfaces.
Current status
Phase 2 is underway. The repository now includes public module contracts, independently versioned capabilities, static module manifests, deterministic automatic discovery, compiled server loading, a staged capability registry, dependency-ordered lifecycle with rollback, and a cloneable backend-only module template. Drizzle, identity, HTTP routing, jobs, physical storage provisioning, surfaces, and feature modules remain later vertical slices.
Quick start
Prerequisites: Node.js 24 LTS, pnpm 11.12, and Docker with Compose.
pnpm install --frozen-lockfile
cp .env.example .env
pnpm infrastructure:up
pnpm modules:validate
pnpm verify
Run pnpm infrastructure:smoke for an isolated end-to-end PostgreSQL and authenticated S3 check.
The development services bind only to loopback:
- PostgreSQL:
127.0.0.1:5432 - S3-compatible object storage:
127.0.0.1:8333
The values in .env.example are development-only and must never be reused in a deployed
environment.
Architecture
- Platform architecture
- Repository boundaries
- Repository workflow
- Module development
- Architecture decisions
No open-source license has been selected yet. A license should be added only after the project owner makes that decision.