nex_animation/nex.config.yaml

66 lines
1.9 KiB
YAML

# NEX 项目配置样例。项目启动时复制为项目根目录 nex.config.yaml 并按实际情况修改。
nex:
system: NEX Design System
version: 0.1.7
compliance: required
project:
name: NexAnimation
type: enterprise-web-app
language: zh-CN
frontend:
framework: react
framework_version: "18"
language: typescript # 当前项目事实;新项目可配置 typescript
build_tool: vite
ui_library: antd
ui_library_version: "5"
styling: css-variables-and-plain-css
router: react-router
state_management: zustand
# NEX 0.1 的项目现状对齐基线,后续如经截图验证可调整
shell:
default: NexAppShell
header_height: 64
sidebar_width: 260
sidebar_collapsed_width: 80
themes:
- light
- dark
page_patterns:
- dashboard
- list
- detail
- form
- settings
- document-workspace
- conversation-workspace
# 项目级设计与体验要求。Agent 必须将这些要求视为实施约束,
# 不能仅把它们当作参考建议。
requirements:
# 可复用的布局、组件和页面模式优先使用 NEX/项目现有共享实现;
# 只有在确认没有合适实现后,才允许新增组件。
use_shared_components: true
# 颜色、字体、间距、圆角、阴影、层级和布局尺寸统一从 Design Tokens 获取;
# 不得在业务页面散落硬编码设计值。
use_design_tokens: true
# 优化 UI/UX 时必须保留现有业务交互和用户已形成的操作路径;
# 如确需改变,必须先说明原因、影响范围和迁移方案,并通过回归验收。
maintain_existing_interactions: true
rules:
hardcoded_design_values: forbidden
direct_ant_design_usage: allowed_for_low_level_components
reusable_patterns_must_use_nex: true
require_light_dark_review: true
require_responsive_review: true
require_keyboard_review: true
preserve_existing_stack: true