中文 | English
Easy UI 是一个面向 Flutter 应用的 UI 组件库，用于构建 Web、桌面端和移动端的产品型界面。它将迁移后的 Easy* 组件、设计 token、交互模式和示例页面统一到一个可复用的 UI 层中，适合需要沉淀内部组件能力、减少重复页面实现的团队使用。
在线示例是当前主要的文档和预览入口：
https://jason-chen-coder.github.io/EasyUI/
示例应用由 example/ 目录通过 GitHub Actions 自动部署，包含独立首页、组件工作台、主题切换、语言切换和 Web 首屏加载反馈。具体组件的演示和配方应放在示例应用中维护，README 只保留项目级信息，避免变成长篇组件用法清单。
- Flutter 原生组件：以 Flutter Widget 形式实现，并通过统一的包入口导出。
- 统一 Easy 命名：迁移后的公开组件遵循
Easy*命名约定。 - 覆盖产品型场景：沉淀表单、数据展示、反馈、内容渲染等常见应用界面能力。
- 主题友好：支持浅色/深色表现，并与 Easy UI 和 Material 主题体系集成。
- 国际化准备：包含生成的本地化元数据，并在示例中提供语言切换。
- Web 预览流程：示例项目会自动构建并部署到 GitHub Pages。
通过 GitHub 添加 Easy UI：
dependencies:
easy_ui:
git:
url: https://github.com/Jason-chen-coder/EasyUI.git
ref: main拉取依赖：
flutter pub get在需要构建界面的地方导入包：
import 'package:easy_ui/easy_ui.dart';仓库内提供了 easy-ui-view-builder AI skill，用于让 Codex、Claude Code 等 AI 编程工具根据需求直接选择 Easy UI 组件并生成 Flutter 视图代码。
通过 npx 从 GitHub 安装到本机。默认会同时安装到 Codex 和 Claude Code：
npx --yes github:Jason-chen-coder/EasyUI默认安装位置：
- Codex：
${CODEX_HOME:-~/.codex}/skills/easy-ui-view-builder - Claude Code：
~/.claude/skills/easy-ui-view-builder
也可以只安装到其中一个目标：
npx --yes github:Jason-chen-coder/EasyUI -- --target codex
npx --yes github:Jason-chen-coder/EasyUI -- --target claude
npx --yes github:Jason-chen-coder/EasyUI -- --target claude-project安装后重启 Codex 或 Claude Code，让新的 skill 被加载。使用时可以直接提到 skill 名称：
$easy-ui-view-builder 帮我用 Easy UI 做一个带筛选、表格、分页和详情抽屉的订单管理页面
如果后续发布到 npm registry，也可以使用同样的参数：
npx --yes easy-ui-skill@latest当前仓库使用以下版本验证：
- Flutter
3.29.2 - Dart
3.7.2
该组件库面向 Flutter Web、桌面端和移动端应用。部分能力依赖平台相关插件；启用文件、通知、H5、PDF 或桌面端相关能力时，请结合示例项目确认平台配置。
easy_ui/
├── lib/ # 组件库源码和公共导出
├── assets/ # 组件使用的资源
├── fonts/ # 内置字体资源
├── test/ # 组件库测试
├── example/ # 可运行的 Flutter 示例应用
└── .github/workflows/ # CI 与 GitHub Pages 部署流程
安装组件库依赖：
flutter pub get运行静态检查和测试：
flutter analyze
flutter test本地运行示例：
cd example
flutter pub get
flutter run -d chrome构建 Web 示例：
cd example
flutter build web --release --no-web-resources-cdn --pwa-strategy=none部署到 GitHub Pages 时，需要使用仓库路径作为 base href：
cd example
flutter build web --release \
--base-href /EasyUI/ \
--no-web-resources-cdn \
--pwa-strategy=noneDeploy Example workflow 会在推送到 main 和 master 时运行。
流程包括：
- 安装组件库依赖
- 运行组件库静态检查
- 运行组件库测试
- 安装示例项目依赖
- 运行示例项目测试
- 构建示例 Web 产物
- 上传 GitHub Pages artifact
- 部署到 GitHub Pages
线上地址：
https://jason-chen-coder.github.io/EasyUI/
贡献代码时请保持当前迁移规则一致：
- 公开组件名使用
Easy*前缀。 - 文件名使用
easy_*约定。 - 示例页面需要保持 Web 端可运行。
- 提交 PR 前运行
flutter analyze和相关测试。 - 不要提交
build/、.dart_tool/或本地平台配置等生成产物。
许可条款记录在 LICENSE 中。发布稳定版本前需要补全最终 license 文本。