项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 1251
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 环境(需支持 npx 命令)
- 一个已有的 React 项目(README 技术栈为 Next.js / TypeScript)
- 可选:支持 MCP 的 AI 编程工具(Cursor、Claude、GitHub Copilot)
- 可访问 npm 源以拉取 lightswind CLI 包
安装与启动步骤
-
1检查 Node 环境
在项目根目录确认 node 与 npx 可用,组件通过 npx 拉取,无需全局安装。
node -v npx -v -
2初始化组件库
运行官方 init 命令,把配置文件与基础组件结构写入你的 React 项目。
npx lightswind@latest init -
3浏览并拉取组件
在官网组件库页面挑选组件,按该组件页面给出的 CLI 命令复制到本地项目执行。
-
4自动配置 MCP
让 CLI 自动识别你的编辑器并写入对应的 MCP 配置文件,供 AI 助手调用。
npx lightswind mcp init -
5手动配置 MCP
若自动检测失败,按官网 MCP Server 文档的 Manual Configuration 章节手动写入编辑器配置。
-
6在项目中改造组件
组件源码已落在你项目内,直接打开文件按业务需求改样式与交互,不与库版本绑定。
如何确认成功
init 命令执行完无报错,项目内出现组件与配置文件;mcp init 后编辑器配置文件中出现对应 MCP 配置项。
常见问题
Q:必须先有 React 项目吗?
A:是的。组件以源码形式复制进你的 React / Next.js 项目,需先准备好项目目录再执行 init。
Q:组件会随库升级自动更新吗?
A:不会。源码进入项目后归你所有,后续改动与维护都在你自己的仓库里完成。
Q:mcp init 没识别到我的编辑器怎么办?
A:改用官网 MCP Server 文档中的手动配置章节,把配置片段写入编辑器对应的配置文件。
Q:需要全局安装 CLI 吗?
A:不需要,README 给的都是 npx 一次性调用方式,用完即走。
注意事项
- README 未列出具体组件拉取命令,请以官网组件页面给出的命令为准。
- 动效组件使用 Framer Motion 与 GSAP,如项目内缺依赖,按组件源码的 import 自行补齐。
- MCP 功能只在支持 MCP 的编辑器中有效,普通编辑器可正常使用组件但不支持 AI 调用。
核心亮点
- 组件数量达 160+,覆盖常见界面需求,且自带 Framer Motion/GSAP 动效,开箱即有较好视觉表现
- 复制粘贴架构让组件代码完全归开发者所有,避免版本升级导致的样式与逻辑锁定,定制自由度高
- 提供 MCP Server,可被 Cursor、Claude、GitHub Copilot 等 AI 编程工具直接调用,契合 AI 辅助开发工作流
不足之处
- 项目星标约 1251,仍处成长阶段,组件 API 与目录结构可能随版本调整,稳定性待观察
- 复制粘贴模式意味着组件缺陷修复不会自动同步,需开发者自行跟进上游变更
- 文档与社区生态相对成熟组件库仍显薄弱,遇到问题可参考的案例和讨论有限
适用场景
- 使用 Next.js 搭建营销落地页,需要大量带动效的展示型组件并快速上线
- 团队使用 Cursor 或 Claude 进行 AI 辅助开发,希望助手直接生成符合统一设计规范的界面代码
- 需要深度定制组件样式与交互,不愿被第三方组件库的版本和主题体系束缚的前端项目
替代项目
shadcn/ui、Aceternity UI、Magic UI
上一篇:design-agent
下一篇:unslop
同类项目推荐
claude-skill
开源
给 Claude 装上电影级落地页设计技能
Free Claude skill: make Claude build award-level, cinematic landing pages. By Motion···
fragment
开源
用 JavaScript 快速上手创意编码,轻松生成视觉艺术与交互动画。
[alpha] A modern toolkit for creative coding
PEmbroider
开源
用代码把图形变成真实刺绣,一键输出机器可读格式
Embroidery Library for Processing
melta-ui
开源
让 Claude Code 和 Cursor 看懂组件,生成界面少返工
人間にも、AIにも、読めるデザインシステム — AI-Ready Design System for Claude Code &···
codex-slides
开源
在 Codex 里用 AI 几分钟生成设计感十足的幻灯片,直接导出 PDF/PPTX
Open-source AI slide studio inside Codex: image-native decks, every slide a full vis···
subjective-zero
开源
用AI和节点图,实时打造视觉特效,无需手写复杂代码。
The agentic node editor for live visual effects
islamic-geometry
开源
输入参数,一键生成精美伊斯兰几何图案
Generative Computational Design of Islamic Geometric Patterns
liquid-logo
开源
在浏览器里拖一拖,秒出液态金属动态 Logo
A free, open-source tool for creating animated logos with a liquid metal aesthetic. ···
diagram-design
开源
让 AI 一句话画出杂志级图表,告别 Mermaid 塑料感
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Dro···
