's'

README.md

@@ -1,36 +1,110 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# 游牧中国 NomadCNA
 
-## Getting Started
+数字游民生活操作系统 (Nomad OS) - 你的下一站，由数据决定
 
-First, run the development server:
+## 项目简介
+
+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
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+打开 [http://localhost:3000](http://localhost:3000) 查看项目。
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+### 生产构建
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+```bash
+npm run build
+npm start
+```
 
-## Learn More
+## 项目结构
 
-To learn more about Next.js, take a look at the following resources:
+```
+├── app/                    # Next.js App Router
+│   ├── components/         # React 组件
+│   ├── context/           # React Context (主题等)
+│   ├── lib/              # 工具库
+│   └── [locale]/         # 国际化路由
+├── config/                # 配置文件
+│   ├── site.config.ts    # 站点配置
+│   ├── nav.config.ts     # 导航配置
+│   ├── footer.config.ts  # 页脚配置
+│   └── ...
+├── public/                # 静态资源
+└── i18n/                  # 国际化配置
+```
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+## 主要页面
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+- `/` - 首页 (城市探索)
+- `/about` - 关于我们
+- `/meetups` - 聚会活动
+- `/dating` - 社区交友
+- `/tools` - 实用工具
+- `/ai` - AI 助手
+- `/gigs` - 赏金任务
+- `/pricing` - 会员价格
+- `/join` - 加入社区
 
-## Deploy on Vercel
+## 配置
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+### 主题配置
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+主题相关逻辑位于 `app/context/ThemeContext.tsx`，支持：
+- 手动切换亮色/暗色模式
+- 记住用户偏好 (localStorage)
+- 跟随系统设置
+
+### 导航配置
+
+导航链接位于 `config/nav.config.ts`，可自定义修改。
+
+### 页脚配置
+
+页脚链接位于 `config/footer.config.ts`，可自定义修改。
+
+## 贡献指南
+
+欢迎提交 Pull Request 和 Issue！
+
+## 许可证
+
+MIT License