Pular para o conteúdo principal

LessonsApp

O LessonsApp é a aplicação de gerenciamento de conteúdo de lições do Lessons.church. Ele oferece uma interface para criar, organizar e publicar currículos de lições para igrejas, desenvolvida com Next.js e React.

Antes de começar

Aviso

O LessonsApp requer o Node.js 22 ou superior. Versões anteriores não são compatíveis.

Configuração​

1. Clone o repositório​

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

2. Instale as dependências​

cd LessonsApp
npm install

3. Configure as variáveis de ambiente​

Copie o arquivo de exemplo de ambiente para .env e configure os endpoints da API:

cp dotenv.sample.txt .env

Atualize as URLs dos endpoints da API para apontar para a sua instância local da LessonsApi (http://localhost:8090). A API de staging do Lessons foi desativada, então substitua quaisquer URLs api.staging.lessons.church que ainda estejam no arquivo de exemplo.

4. Inicie o servidor de desenvolvimento​

npm run dev

O servidor de desenvolvimento do Next.js inicia em http://localhost:3501.

Comandos principais​

ComandoDescrição
npm run devInicia o servidor de desenvolvimento do Next.js na porta 3501
npm run buildGera o build de produção via Next.js

Stack tecnológica​

  • Next.js 16 com TypeScript
  • React 19 para os componentes de interface
  • Pacotes @churchapps/apphelper* para componentes compartilhados
Info

O LessonsApp se comunica com o backend LessonsApi, que é uma API separada da API principal da ChurchApps. Certifique-se de que o ambiente esteja configurado com o endpoint correto da API de Lessons.

Implantação​

As builds de produção são implantadas no S3 + CloudFront:

  1. npm run build gera o build otimizado do Next.js
  2. O resultado do build é sincronizado com um bucket do S3
  3. A invalidação do CloudFront é disparada para servir a nova versão
Dica

Para instruções detalhadas de implantação, veja o guia Implantação de Aplicativos Web.