111 lines
2.6 KiB
Markdown
111 lines
2.6 KiB
Markdown
# 游牧中国 NomadCNA
|
||
|
||
数字游民生活操作系统 (Nomad OS) - 你的下一站，由数据决定
|
||
|
||
## 项目简介
|
||
|
||
NomadCNA 是一个面向数字游民的站式生活平台，提供城市决策、税务签证、智能匹配、赏金任务等功能。从 Free 到 Pro，开启你的游牧人生。
|
||
|
||
## 技术栈
|
||
|
||
- **前端框架**: Next.js 16 (App Router)
|
||
- **UI 框架**: React 19 + Tailwind CSS 4
|
||
- **样式**: Tailwind CSS
|
||
- **字体**: Geist (Vercel)
|
||
- **数据库**: PocketBase
|
||
- **对象存储**: MinIO
|
||
- **语言**: TypeScript
|
||
|
||
## 功能特性
|
||
|
||
- 🌏 **城市探索** - 发现最适合数字游民的中国城市
|
||
- 📍 **城市数据** - 成本、生活质量、网络速度等数据对比
|
||
- 🎯 **智能匹配** - 根据个人偏好推荐适合的城市
|
||
- 🤝 **社区聚会** - 与各地游民建立联系
|
||
- 💬 **社区互动** - 论坛、话题讨论
|
||
- 🛠️ **实用工具** - 汇率、天气等实用工具
|
||
- 🌙 **暗色模式** - 支持亮色/暗色主题切换
|
||
- 🌐 **国际化** - 支持中文/英文
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Node.js 18+
|
||
- npm / yarn / pnpm / bun
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 开发模式
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
打开 [http://localhost:3000](http://localhost:3000) 查看项目。
|
||
|
||
### 生产构建
|
||
|
||
```bash
|
||
npm run build
|
||
npm start
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
├── app/ # Next.js App Router
|
||
│ ├── components/ # React 组件
|
||
│ ├── context/ # React Context (主题等)
|
||
│ ├── lib/ # 工具库
|
||
│ └── [locale]/ # 国际化路由
|
||
├── config/ # 配置文件
|
||
│ ├── site.config.ts # 站点配置
|
||
│ ├── nav.config.ts # 导航配置
|
||
│ ├── footer.config.ts # 页脚配置
|
||
│ └── ...
|
||
├── public/ # 静态资源
|
||
└── i18n/ # 国际化配置
|
||
```
|
||
|
||
## 主要页面
|
||
|
||
- `/` - 首页 (城市探索)
|
||
- `/about` - 关于我们
|
||
- `/meetups` - 聚会活动
|
||
- `/dating` - 社区交友
|
||
- `/tools` - 实用工具
|
||
- `/ai` - AI 助手
|
||
- `/gigs` - 赏金任务
|
||
- `/pricing` - 会员价格
|
||
- `/join` - 加入社区
|
||
|
||
## 配置
|
||
|
||
### 主题配置
|
||
|
||
主题相关逻辑位于 `app/context/ThemeContext.tsx`，支持：
|
||
- 手动切换亮色/暗色模式
|
||
- 记住用户偏好 (localStorage)
|
||
- 跟随系统设置
|
||
|
||
### 导航配置
|
||
|
||
导航链接位于 `config/nav.config.ts`，可自定义修改。
|
||
|
||
### 页脚配置
|
||
|
||
页脚链接位于 `config/footer.config.ts`，可自定义修改。
|
||
|
||
## 贡献指南
|
||
|
||
欢迎提交 Pull Request 和 Issue！
|
||
|
||
## 许可证
|
||
|
||
MIT License
|