Registry-first
组件、样式 token、工具函数和规则通过 registry 复制到业务项目，开发者拿到的是源码。
v0 scope95 个 UI 组件
registry101 个 items
distributionGitHub Pages registry
runtimeTaro React + Vite
ruleNo Radix / No DOM API
Repository contract
不是 npm 黑盒组件包，是可审计、可改造、可让 Agent 消费的源码系统。
主仓库同时承载组件源码、CLI、registry builder、Taro playground、文档站和 AI 编码规则。每个功能都必须能从 registry 到小程序构建链路被验证。
Taro-safe
组件基于 @tarojs/components，不依赖 Radix、ReactDOM、浏览器 DOM API 或 portal。
Agent-ready
AGENTS.md、UI rules、doctor 检查和测试门禁，让 AI Coding 有明确边界。
Developer path
开发链路应该像命令行一样清楚。
首页只保留开发者真正需要的路径：初始化、添加组件、检查项目、进入小程序构建。 其它细节放到对应文档页里继续展开。
- 01生成项目约定
pnpm dlx vekui init --cwd . --yes - 02复制组件源码
pnpm dlx vekui add button input --cwd . - 03检查 Taro / CSS / 禁用依赖
pnpm dlx vekui doctor --cwd . - 04进入微信小程序构建链路
pnpm build:miniprogram
Quality gates
每次合并都跑完整门禁，不靠感觉判断能不能用。
pnpm typecheck检查 TypeScript 项目类型边界。
pnpm test运行 workspace 内所有自动化测试。
pnpm check:ui扫描 UI 边界、组件契约和 Tailwind 安全规则。
pnpm registry:build生成 shadcn-compatible registry JSON。
pnpm build:miniprogram用 Taro Vite compiler 构建微信小程序。
pnpm build:docs构建文档站并验证 public registry 输出。
Development plan
Roadmap 已清零，下一阶段只做会提高开发者信任感的事情。
- 让 95 个 UI 组件和 101 个 registry items 的文档口径持续同源。
- 把 CLI 的 dry-run、覆盖确认、registryDependencies 解析做成可预期体验。
- 把 action、navigation、form、view 和 layout playground 保持为真实组件验收台。
- 把 GitHub Pages 上的 registry、文档、Changelog 和 AI 入口保持同步发布。
Docs map
按任务进入文档。
安装组件、理解 registry、配置主题、同步 AI 规则和小程序验证，都保持在同一条源码分发链路里。
Quick Start从空 Taro 项目接入 VekUI
最短路径完成 init、add 和 doctor。
→Components浏览可安装组件查看 95 个已发布组件，roadmap planned 已清零。
→CLIinit / add / list / doctor理解命令输入、输出和项目检查边界。
→Registry/r/index.json 与组件条目确认 CLI 消费的 public contract。
→Theme语义 token 与 Tailwind 入口保持小程序安全的样式和主题约束。
→AI CodingAgent 规则和实现边界同步可执行规则，减少实现偏差。
→Contributing组件贡献闭环从 API、测试、文档到 registry 的验收路径。
→Changelog发布记录和 v0 基线追踪已发布能力和版本变化。
→