Vai al contenuto principale

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

Avviso

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​

ComandoDescrizione
npm run devAvvia il server di sviluppo Next.js sulla porta 3501
npm run buildBuild 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
Info

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:

  1. npm run build genera la build ottimizzata di Next.js
  2. L'output della build viene sincronizzato su un bucket S3
  3. Viene attivata l'invalidazione di CloudFront per servire la nuova versione
Suggerimento

Per le istruzioni dettagliate sul deploy, vedi la guida Deploy delle web app.