Document locale detection, language easter egg, and deploy pointers in README.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
eric
2026-08-03 09:11:00 -05:00
parent 9c2eeb9df2
commit ba0b1058b0

View File

@@ -1,36 +1,78 @@
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).
# Nomadro
## Getting Started
中文数字游民操作系统官网([nomadro.com](https://nomadro.com))。
First, run the development server:
基于 Next.js App Router,提供游民导航、地理套利、直播工具箱等入口聚合。
## 技术栈
- Next.js 16 / React 19 / TypeScript
- Tailwind CSS 4
- pnpm
- 中文用户识别:[is-china-user](https://github.com/yArna/isChinaUser)
## 本地开发
```bash
npm run dev
# or
yarn dev
# or
pnpm install
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
pnpm build # 生产构建
pnpm start # 启动生产服务
pnpm lint # 代码检查
```
## Learn More
## 多语言
To learn more about Next.js, take a look at the following resources:
默认根据浏览器环境自动判断语言:
- [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!
实现要点:
## Deploy on Vercel
| 文件 | 作用 |
| --- | --- |
| `components/locale-provider.tsx` | 调用 `isChinaUser()`,提供 locale 上下文 |
| `lib/i18n.ts` | 中英文案字典 |
| `components/language-switcher.tsx` | 语言下拉(默认隐藏) |
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.
语言下拉默认不展示。在页面**右上角区域 2.5 秒内连点 5 次**后会出现下拉框,可手动切换中文 / English。
- 解锁状态保存在当前标签页的 `sessionStorage`(`nomadro-lang-unlock`)
- 仅在已解锁时,手动选择的语言会写入 `localStorage`(`nomadro-locale`)并优先生效
- 关闭标签页后恢复:重新按中文用户识别自动选语言,下拉再次隐藏
## 项目结构(简要)
```
app/ # 页面(首页 / about / contact)
components/ # UI 与 locale 相关组件
lib/data.ts # 入口卡片等业务数据
lib/i18n.ts # 多语言文案
deploy/ # 服务器部署脚本与说明
```
## 部署
生产域名:`nomadro.com`(`www` 301 到主域)。
详细步骤见 [`deploy/README.md`](./deploy/README.md)。
日常更新(服务器已部署过):
```bash
ssh root@<server>
cd /var/www/nomadro.com
bash deploy/deploy.sh
```
当前发布分支默认为 `test`。