跳到主要内容

LessonsApp

LessonsApp 是 Lessons.church 的课程内容管理应用。它提供了一个用于创建、组织和发布教会课程体系的界面,基于 Next.js 和 React 构建。

开始之前

  • 安装 Node.js 22+ 和 Git —— 参见前置条件
  • 配置您的 API 目标(本地 LessonsApi)—— 参见环境变量
注意

LessonsApp 需要 Node.js 22 或更高版本。不支持更早的版本。

设置​

1. 克隆代码仓库​

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

2. 安装依赖​

cd LessonsApp
npm install

3. 配置环境变量​

将环境变量示例文件复制为 .env,并配置 API 端点:

cp dotenv.sample.txt .env

将 API 端点 URL 更新为指向您的本地 LessonsApi 实例(http://localhost:8090)。预发布的 Lessons API 已停用,因此请替换示例文件中残留的所有 api.staging.lessons.church URL。

4. 启动开发服务器​

npm run dev

Next.js 开发服务器将在 http://localhost:3501 启动。

常用命令​

命令说明
npm run dev在 3501 端口启动 Next.js 开发服务器
npm run build通过 Next.js 进行生产构建

技术栈​

  • Next.js 16,使用 TypeScript
  • React 19,用于 UI 组件
  • @churchapps/apphelper* 包,提供共享组件
信息

LessonsApp 与 LessonsApi 后端通信,这是一个独立于主 ChurchApps Api 的 API。请确保您的环境配置了正确的 Lessons API 端点。

部署​

正式构建会部署到 S3 + CloudFront:

  1. npm run build 生成优化后的 Next.js 构建产物
  2. 将构建输出同步到 S3 存储桶
  3. 触发 CloudFront 失效,以提供新版本
提示

有关详细的部署说明,请参阅 Web 应用部署 指南。