Files
Ekklesia/README.md
T
ekklesia 7b448d8706
CI / verify (push) Successful in 2m14s
CI / infrastructure-smoke (push) Failing after 1m36s
feat: add module runtime lifecycle
2026-07-12 22:49:51 -05:00

1.6 KiB

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

No open-source license has been selected yet. A license should be added only after the project owner makes that decision.