docs: clarify UI preview system works without server

Updated README documentation to emphasize that index.html and compare.html
can be opened directly in browser without requiring a local server.
Reorganized preview instructions to highlight direct browser preview as
the recommended approach, with local server as optional for advanced features.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-10-13 11:03:35 +08:00
parent bbf88826ba
commit 5ca246a37c
2 changed files with 24 additions and 14 deletions

View File

@@ -662,22 +662,26 @@ URL/Images → capture/explore-layers
#### Preview System #### Preview System
After running `ui-generate`, you get interactive preview tools: After running `ui-generate`, you get interactive preview tools that **work directly in the browser without requiring a server**:
**Quick Preview** (Direct Browser): **Direct Browser Preview** (Recommended - No Server Required):
```bash ```bash
# Navigate to prototypes directory # Navigate to prototypes directory
cd .workflow/WFS-auth/.design/prototypes cd .workflow/WFS-auth/.design/prototypes
# Open index.html in browser (double-click or):
# Open in browser (double-click the file, or use command):
open index.html # macOS open index.html # macOS
start index.html # Windows start index.html # Windows
xdg-open index.html # Linux xdg-open index.html # Linux
# Both index.html and compare.html work directly without a server
open compare.html # Open comparison view directly
``` ```
**Full Preview** (Local Server - Recommended): **Optional: Local Server** (For advanced features):
```bash ```bash
cd .workflow/WFS-auth/.design/prototypes cd .workflow/WFS-auth/.design/prototypes
# Choose one: # Choose one if you need server-side features:
python -m http.server 8080 # Python python -m http.server 8080 # Python
npx http-server -p 8080 # Node.js npx http-server -p 8080 # Node.js
php -S localhost:8080 # PHP php -S localhost:8080 # PHP
@@ -685,11 +689,12 @@ php -S localhost:8080 # PHP
``` ```
**Preview Features**: **Preview Features**:
- `index.html`: Master navigation with all prototypes - `index.html`: Master navigation with all prototypes (works offline)
- `compare.html`: Side-by-side comparison with viewport controls (Desktop/Tablet/Mobile) - `compare.html`: Side-by-side comparison with viewport controls (works offline)
- Synchronized scrolling for layout comparison - Synchronized scrolling for layout comparison
- Dynamic page switching - Dynamic page switching
- Real-time responsive testing - Real-time responsive testing
- **No server required** - all features work by opening files directly in browser
#### 📦 Output Structure #### 📦 Output Structure

View File

@@ -662,22 +662,26 @@ URL/图像 → capture/explore-layers
#### 预览系统 #### 预览系统
运行 `ui-generate` 后,您将获得交互式预览工具: 运行 `ui-generate` 后,您将获得交互式预览工具**无需启动服务器即可直接在浏览器中使用**
**快速预览**直接浏览器): **直接浏览器预览**推荐 - 无需服务器):
```bash ```bash
# 导航到原型目录 # 导航到原型目录
cd .workflow/WFS-auth/.design/prototypes cd .workflow/WFS-auth/.design/prototypes
# 在浏览器中打开 index.html双击或执行:
# 在浏览器中打开(双击文件或使用命令):
open index.html # macOS open index.html # macOS
start index.html # Windows start index.html # Windows
xdg-open index.html # Linux xdg-open index.html # Linux
# index.html 和 compare.html 都可以直接打开,无需服务器
open compare.html # 直接打开对比视图
``` ```
**完整预览**(本地服务器 - 推荐: **可选:本地服务器**(用于高级功能:
```bash ```bash
cd .workflow/WFS-auth/.design/prototypes cd .workflow/WFS-auth/.design/prototypes
# 选择一个: # 如果需要服务器端功能,可选择一个:
python -m http.server 8080 # Python python -m http.server 8080 # Python
npx http-server -p 8080 # Node.js npx http-server -p 8080 # Node.js
php -S localhost:8080 # PHP php -S localhost:8080 # PHP
@@ -685,11 +689,12 @@ php -S localhost:8080 # PHP
``` ```
**预览功能**: **预览功能**:
- `index.html`: 包含所有原型的主导航 - `index.html`: 包含所有原型的主导航(离线可用)
- `compare.html`: 带视口控制的并排对比(桌面/平板/移动 - `compare.html`: 带视口控制的并排对比(离线可用
- 同步滚动用于布局对比 - 同步滚动用于布局对比
- 动态页面切换 - 动态页面切换
- 实时响应式测试 - 实时响应式测试
- **无需服务器** - 所有功能都可通过直接在浏览器中打开文件来使用
#### 📦 输出结构 #### 📦 输出结构