LessonsApp
LessonsApp ist die Lesson-Content-Management-Anwendung für Lessons.church. Sie bietet eine Schnittstelle zum Erstellen, Organisieren und Veröffentlichen von Kirchenlehrplan-Lektionen, gebaut mit Next.js und React.
Vor dem Start
- Installieren Sie Node.js 22+ und Git — siehe Voraussetzungen
- Konfigurieren Sie Ihr API-Ziel (Staging oder lokal) — siehe Umgebungsvariablen
LessonsApp benötigt Node.js 22 oder später. Frühere Versionen werden nicht unterstützt.
Setup
1. Repository klonen
git clone https://github.com/ChurchApps/LessonsApp.git
2. Abhängigkeiten installieren
cd LessonsApp
npm install
3. Umgebungsvariablen konfigurieren
Kopieren Sie die Environment-Sample-Datei zu .env und konfigurieren Sie die API-Endpoints:
cp dotenv.sample.txt .env
Aktualisieren Sie die API-Endpoint-URLs, um auf die Staging-API oder Ihre lokale API-Instanz zu zeigen.
4. Dev-Server starten
npm run dev
Der Next.js-Dev-Server startet bei http://localhost:3501.
Wichtige Befehle
| Befehl | Beschreibung |
|---|---|
npm run dev | Next.js-Dev-Server auf Port 3501 starten |
npm run build | Production-Build via Next.js |
Tech-Stack
- Next.js 16 mit TypeScript
- React 19 für UI-Komponenten
@churchapps/apphelper*-Packages für gemeinsame Komponenten
LessonsApp kommuniziert mit dem LessonsApi-Backend, das eine separate API vom Main-ChurchApps-Api ist. Stellen Sie sicher, dass Ihre Umgebung mit dem korrekten Lessons-API-Endpoint konfiguriert ist.
Deployment
Production-Builds sind zu S3 + CloudFront deployed:
npm run buildgeneriert den optimierten Next.js-Build- Build-Output wird zu einem S3-Bucket synced
- CloudFront-Invalidation wird ausgelöst, um die neue Version zu servieren
Für detaillierte Deployment-Anweisungen, siehe Web-App-Deployment-Leitfaden.