Vai al contenuto principale

LessonsApp

LessonsApp è l'applicazione per la gestione dei contenuti delle lezioni per Lessons.church. Fornisce un'interfaccia per creare, organizzare e pubblicare programmi di lezioni per la chiesa, costruita 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 di ambiente

Copia il file di esempio dell'ambiente in .env e configura gli endpoint API:

cp dotenv.sample.txt .env

Aggiorna gli URL degli endpoint API per puntare alle API di staging o alla tua istanza API locale.

4. Avvia il server di sviluppo

npm run dev

Il server di sviluppo Next.js si avvia su 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 UI
  • Pacchetti @churchapps/apphelper* per i componenti condivisi
Info

LessonsApp comunica con il backend LessonsApi, che è un'API separata dall'Api principale di ChurchApps. Assicurati che il tuo ambiente sia configurato con l'endpoint corretto dell'API Lessons.

Distribuzione

Le build di produzione vengono distribuite su S3 + CloudFront:

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

Per istruzioni dettagliate sulla distribuzione, vedi la guida alla Distribuzione delle Applicazioni Web.