@@ -5,9 +5,9 @@ This document provides development guidelines and rules for AI Agents to ensure
55## 📋 Project Overview
66
77- ** Project Name** : RustFS.com - Official Website
8- - ** Framework** : Next.js 15.3.4 (App Router, Static Export)
9- - ** Language** : TypeScript (ES2017 +, Strict Mode)
10- - ** Package Manager** : pnpm (recommended) or npm
8+ - ** Framework** : Next.js 16.1.6 (App Router, Static Export)
9+ - ** Language** : TypeScript (ES2022 +, Strict Mode)
10+ - ** Package Manager** : pnpm
1111- ** Styling** : Tailwind CSS 4 + shadcn/ui
1212- ** CI/CD** : GitHub Actions → Aliyun OSS
1313
@@ -28,8 +28,6 @@ This document provides development guidelines and rules for AI Agents to ensure
2828
2929 ``` bash
3030 pnpm run lint
31- # or
32- npm run lint
3331 ```
3432
35333 . ** ✅ Local Build Test**
@@ -40,25 +38,14 @@ This document provides development guidelines and rules for AI Agents to ensure
4038
4139 # Execute build
4240 pnpm run build
43- # or
44- npm run build
4541
4642 # Ensure build succeeds without errors
4743 ```
4844
49454 . ** ✅ Dependency Lock File Synchronization**
50-
51- - If using ` npm install ` to update dependencies, must synchronize ` pnpm-lock.yaml ` :
52-
53- ``` bash
54- pnpm install
55- ```
56-
5746 - If using ` pnpm install ` to update dependencies, ensure ` pnpm-lock.yaml ` is updated
58- - ** Important** : CI uses pnpm. If dependencies are updated locally with npm but ` pnpm-lock.yaml` is not updated, CI will fail
5947
60485 . ** ✅ Build Artifact Verification**
61-
6249 - Ensure ` out/ ` directory is generated
6350 - Ensure ` out/sitemap.xml ` is generated (automatically by postbuild script)
6451 - Check build artifacts are complete
@@ -71,20 +58,18 @@ According to `.github/workflows/deploy.yml`, the CI process includes:
7158
72591 . ** Checkout** : Check out code
7360
74- 2. ** Install dependencies ** :
61+ 2 . ** Install pnpm ** :
7562
76- ` ` ` bash
77- npm install -g pnpm && pnpm install
78- ` ` `
63+ 3 . ** Use Node.js** :
7964
80- 3 . ** Install dependencies and build** :
65+ 4 . ** Install dependencies and build** :
8166
8267 ``` bash
8368 pnpm install --no-frozen-lockfile
8469 pnpm run build
8570 ```
8671
87- 4 . ** Deploy** : Deploy to Aliyun OSS
72+ 5 . ** Deploy** : Deploy to Aliyun OSS
8873
8974### Local CI Simulation
9075
@@ -95,7 +80,6 @@ Before committing, it's recommended to simulate the complete CI process locally:
9580rm -rf node_modules .next out
9681
9782# 2. Install dependencies (using pnpm, consistent with CI)
98- npm install -g pnpm
9983pnpm install
10084
10185# 3. Build project
@@ -147,7 +131,7 @@ Examples:
147131
148132``` bash
149133feat: add contact form with hCaptcha
150- fix: update pnpm-lock.yaml after npm dependency changes
134+ fix: correct button alignment on mobile
151135docs: update README with new features
152136```
153137
@@ -159,7 +143,6 @@ docs: update README with new features
159143
160144** Causes** :
161145
162- - Dependencies updated locally with npm but `pnpm-lock.yaml` not updated
163146- ` pnpm-lock.yaml ` out of sync with ` package.json `
164147
165148** Solution** :
0 commit comments