LessonsApp
LessonsApp 是 Lessons.church 的课程内容管理应用。它提供了一个用于创建、组织和发布教会课程体系的界面,基于 Next.js 和 React 构建。
注意
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:
npm run build生成优化后的 Next.js 构建产物- 将构建输出同步到 S3 存储桶
- 触发 CloudFront 失效,以提供新版本
提示
有关详细的部署说明,请参阅 Web 应用部署 指南。