开源社官网

该项目是使用 create-next-app 脚手架引导安装，基于 TypeScript、Next.js、Bootstrap 和 Workbox 的 React 项目。

主要功能

本站不仅承担传统官网的职能，还是一个同时具备 SSR 和 PWA 能力的 Web 前端基座，与开源社其它应用项目的前端模块组成一个矩阵。

开源社文库

• 前端主页
• 前端代码
• 后端服务
• 后端代码

开放治理系统

• 项目简介
• 前端主页
• 前端代码
• 后端服务
  • 人
  • 事
• 后端代码
  • 人
  • 事

开放会务系统

• 项目简介
• 前端主页
• 前端代码
• 后端服务
  • 模板
  • 生产
• 后端代码

中国开源地图

• 项目简介
• 前端主页
• 前端代码
• 后端服务
• 后端代码

中国公益地图

• 项目简介
• 前端主页
• 前端代码
• 后端服务
• 后端代码

开源协作

• 申请加入开源社志愿者，填表后组长会联系你加入飞书组织：https://kaiyuanshe.feishu.cn/share/base/shrcnfO89tYlYIjZpS5PXJBaK2f
• 参与代码贡献：⚠️ 由于官网项目需要调用飞书 API，需要预先配置才能在本地运行，所有必须先申请加入 https://github.com/kaiyuanshe 组织后，再贡献代码，不能直接 fork 仓库贡献代码。⚠️

项目技术栈

• 编程语言: TypeScript v5
• 组件引擎: Next.js v15
• 组件套件: Bootstrap v5
• PWA 框架: Workbox v6
• 状态管理: MobX v6
• CI / CD: GitHub Actions + Vercel

启动

第一步，在 NPM 中登录 GitHub 账号；

第二步，安装依赖并运行开发服务器:

npm i pnpm -g
pnpm i
pnpm dev

在浏览器中打开 http://localhost:3000 查看结果。

API routes 可以通过 http://localhost:3000/api/hello 访问，对应端点可以在 pages/api/hello.ts 中进行修改。

pages/api 目录映射为 /api/*。此目录中的文件被视为 API routes 而不是 React 页面。

• Next.js 文档 - 了解 Next.js 功能和 API
• 学习 Next.js - 一个交互式 Next.js 教程

你可以查看 Next.js 的 GitHub 仓库 - 欢迎提供反馈和贡献！

部署

Vercel

• 部署 Next.js 应用程序的最简单方法是使用 Next.js 创建者 Vercel 提供的 Vercel 平台。

• 查看 Next.js 部署文档 了解更多详细信息。

Docker

pnpm pack-image
pnpm container