用途:在现有或新建的 Next.js 应用中集成 ibl.ai 组件与功能,或从模板创建新应用。
主要能力:提供认证与 SSO、用户资料与账户、平台与组织切换、分析仪表盘、通知、导师 UI、工作流、内容展示、错误处理等组件,均来自 @iblai/iblai-js/web-containers。可用 MCP 工具 get_component_info、get_hook_info 查询完整属性与用法。
使用方式:先检查项目根目录的 iblai.env,确认 PLATFORM、DOMAIN、TOKEN 变量;缺失时提示用户下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。默认使用 pnpm,未安装则回退 npm。新建应用可克隆 vibe-starter:git clone -b spa https://github.com/iblai/vibe-starter.git vibe-starter-init,再 cp -a vibe-starter-init/. . && rm -rf vibe-starter-init,然后 pnpm install。也可从 npx create-next-app@latest 开始,运行 /iblai-auth 技能后逐步添加功能。
设计系统:若项目已有设计系统(如 shadcn、自定义 CSS 变量、Tailwind 扩展、自定义字体、现有外壳组件),应遵循项目令牌,不覆盖为 ibl.ai 默认品牌;否则使用 BRAND.md 默认值。生成前需用一行说明检测结果。
限制:iblai.env 仅存 3 个简写变量,不是 .env.local 替代;Next.js 仍从 .env.local 读取运行时变量。AnalyticsFinancialStats 不接受 basePath 属性,其他分析子页面组件接受。shadcn Sheet 使用 @base-ui/react/dialog,SheetTrigger 无 asChild 属性。未提供收费、价格、平台支持范围等信息。