Vai al contenuto principale

B1App

B1App è l'applicazione pubblica per i membri della chiesa costruita con Next.js. Fornisce l'esperienza utente per i membri, inclusi profili, directory dei gruppi, streaming dal vivo e pagine per le donazioni.

Prima di Iniziare

Avviso

B1App richiede Node.js 22 o successivo. Le versioni precedenti non sono supportate.

Configurazione​

1. Clona il repository​

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

2. Installa le dipendenze​

cd B1App
npm install

3. Configura le variabili di ambiente​

cp dotenv.sample.txt .env

Apri .env e configura gli URL degli endpoint NEXT_PUBLIC_*_API. Questi possono 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:3301.

Comandi Principali​

ComandoDescrizione
npm run devAvvia il server di sviluppo Next.js sulla porta 3301
npm run buildBuild di produzione tramite Next.js
npm run testEsegui test end-to-end con Playwright
npm run lintEsegui lint di Next.js

Variabili di Ambiente Principali​

VariabileDescrizione
NEXT_PUBLIC_*_APIURL degli endpoint API per ogni modulo
Info

Lo script postinstall copia i file di localizzazione e CSS da @churchapps/apphelper. Se i componenti appaiono senza stili dopo l'installazione, esegui npm run postinstall manualmente.

Stack Tecnologico​

  • Next.js 16 con TypeScript
  • React 19 per i componenti UI
  • Material-UI 7 per il design system
  • React Query 5 per la gestione dello stato del server
  • Pacchetti @churchapps/apphelper* per i componenti condivisi

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.