Zum Hauptinhalt springen

B1App

B1App ist die öffentlich zugängliche Mitglieder-Anwendung der Kirche, entwickelt mit Next.js. Sie bietet das Mitgliedererlebnis mit Profilen, Gruppenverzeichnissen, Live-Streaming und Spendenseiten.

Bevor Sie beginnen

Warnung

B1App erfordert Node.js 22 oder neuer. Frühere Versionen werden nicht unterstützt.

Einrichtung​

1. Repository klonen​

git clone https://github.com/ChurchApps/B1App.git

2. Abhängigkeiten installieren​

cd B1App
npm install

3. Umgebungsvariablen konfigurieren​

cp dotenv.sample.txt .env

Öffnen Sie .env und konfigurieren Sie die URLs der Endpunkte NEXT_PUBLIC_*_API. Diese können auf die gemeinsame Demo-API (https://api.demo.churchapps.org) oder auf Ihre lokale API-Instanz zeigen. Die Beispieldatei enthält unter Umständen noch eingestellte Staging-URLs; ersetzen Sie diese.

4. Entwicklungsserver starten​

npm run dev

Der Next.js-Entwicklungsserver startet unter http://localhost:3301.

Wichtige Befehle​

BefehlBeschreibung
npm run devNext.js-Entwicklungsserver auf Port 3301 starten
npm run buildProduktionsbuild über Next.js
npm run testEnd-to-End-Tests mit Playwright ausführen
npm run lintNext.js-Lint ausführen

Wichtige Umgebungsvariablen​

VariableBeschreibung
NEXT_PUBLIC_*_APIAPI-Endpunkt-URLs für jedes Modul
Info

Das Skript postinstall kopiert Locale- und CSS-Dateien aus @churchapps/apphelper. Wirken Komponenten nach der Installation unformatiert, führen Sie npm run postinstall manuell aus.

Technologie-Stack​

  • Next.js 16 mit TypeScript
  • React 19 für UI-Komponenten
  • Material-UI 7 als Designsystem
  • React Query 5 für den Serverstatus
  • @churchapps/apphelper*-Pakete für gemeinsam genutzte Komponenten

Bereitstellung​

Produktionsbuilds werden auf S3 + CloudFront bereitgestellt:

  1. npm run build erzeugt den optimierten Next.js-Build
  2. Die Build-Ausgabe wird in einen S3-Bucket synchronisiert
  3. Eine CloudFront-Invalidierung wird ausgelöst, damit die neue Version ausgeliefert wird
Tipp

Ausführliche Anweisungen zur Bereitstellung finden Sie im Leitfaden Bereitstellung der Web-Apps.