SuperAPI AI 工具集

fulldev-ui

前端与建站

查看项目

更新于 10-15 21:48

技能介绍

用途:Fulldev UI 把 shadcn/ui 的 token、样式、预设与 CLI 带到 Astro,并提供内容型组件(如 section、banner、header、typography)和页面区块;React 扩展把这些额外组件与区块加入官方 shadcn/ui React 项目。CLI、注册表、语义 token 与设计原则沿用 shadcn skill,两者冲突时以本 skill 为准。

主要能力:注册表地址为 https://ui.full.dev/r/styles/{style}/{name}.json,旧地址不带 {style} 时始终安装 Vega。仅提供 Base UI 样式(base-vega、base-nova 等)配 Lucide 图标。@fulldev/components 与 @fulldev/blocks 代替 add --all。组件使用容器查询变体(如 @2xl:),页面内容需要 @container 祖先(如 LayoutMain 或 body)。Astro 组件没有 asChild 或 render,可换元素的组件用 as,Button 收到 href 时渲染为链接;交互组件依赖 @data-slot/* 脚本,需保留其结构与状态属性。

使用方式:新项目用 init https://ui.full.dev/r/styles/base-<style>/base.json,不要用 init --preset,再执行 <preset> --only theme,font。已有 components.json 时切勿运行 init(会替换主题 token),应先添加注册表,再添加 @fulldev/init。React 项目用官方 shadcn init 与 Base UI 样式,再加注册表 https://ui.full.dev/r/react/styles/{style}/{name}.json。组件 API 可读已安装源码及 https://ui.full.dev/components/<name>.md,入口为 llms.txt 或 react/llms.txt。

适用场景:使用 Fulldev UI、@fulldev 的 Astro 组件与区块,或其 React 扩展的项目。

限制:完整 apply 会加入 Fulldev UI 并不使用的 @base-ui/react 与 lucide-react;不支持预设菜单颜色。定制优先用内置 variants 与 size props,单实例 class 仅用于布局;改外观应编辑样式表中的主题 token,再按 data-slot、data-variant、data-size 添加规则,最后才改已安装文件;不要直接编辑 cva variants 或组件类。设计系统页面辅助仅限 React。预设字体从 Fontsource 加载,项目若用其他方式加载字体需保留一种。区块为可移植 section,只接收普通 props,不导入项目 schema、内容、布局或路由;Astro 转发 class,React 用 className,并于根节点以 cn() 合并。