LessonsApp
LessonsApp è l'applicazione di gestione dei contenuti delle lezioni per Lessons.church. Fornisce un'interfaccia per creare, organizzare e pubblicare i curricula delle lezioni della chiesa, sviluppata con Next.js e React.
Prima di iniziare
- Installa Node.js 22+ e Git -- vedi Prerequisiti
- Configura il target dell'API (LessonsApi in locale) -- vedi Variabili d'ambiente
LessonsApp richiede Node.js 22 o successivo. Le versioni precedenti non sono supportate.
Configurazione
1. Clona il repository
git clone https://github.com/ChurchApps/LessonsApp.git
2. Installa le dipendenze
cd LessonsApp
npm install
3. Configura le variabili d'ambiente
Copia il file di esempio delle variabili d'ambiente in .env e configura gli endpoint delle API:
cp dotenv.sample.txt .env
Aggiorna gli URL degli endpoint API in modo che puntino alla tua istanza locale di LessonsApi (http://localhost:8090). L'API di staging di Lessons è stata dismessa, quindi sostituisci gli eventuali URL api.staging.lessons.church rimasti nel file di esempio.
4. Avvia il server di sviluppo
npm run dev
Il server di sviluppo Next.js si avvia all'indirizzo http://localhost:3501.
Comandi principali
| Comando | Descrizione |
|---|---|
npm run dev | Avvia il server di sviluppo Next.js sulla porta 3501 |
npm run build | Build di produzione tramite Next.js |
Stack tecnologico
- Next.js 16 con TypeScript
- React 19 per i componenti dell'interfaccia
@churchapps/apphelper*pacchetti per i componenti condivisi
LessonsApp comunica con il backend LessonsApi, che è un'API separata dalla principale ChurchApps Api. Assicurati che il tuo ambiente sia configurato con l'endpoint corretto dell'API di Lessons.
Deploy
Le build di produzione vengono distribuite su S3 + CloudFront:
npm run buildgenera la build ottimizzata di Next.js- L'output della build viene sincronizzato su un bucket S3
- Viene attivata l'invalidazione di CloudFront per servire la nuova versione
Per le istruzioni dettagliate sul deploy, vedi la guida Deploy delle web app.