About this project

Lightswind UI is a React component library whose README is written in English. It uses a source-code distribution model: components are installed into the user's project through the Lightswind CLI rather than imported from a runtime package. The project advertises more than 160 animated, accessible components and groups them into categories such as 3D elements, backgrounds, advanced components, buttons, text effects, cursor effects, UI core, form controls, and layout/navigation. Requirements listed are Node.js 18 or newer, React 18 or 19, Tailwind CSS v3 or v4, and a Next.js, Vite, Remix, or CRA project. The CLI supports init, add, list, Pro authentication, and MCP commands. It detects frameworks, resolves component prerequisites, installs shared utilities, and registers a Tailwind plugin. The README states that components live in components/lightswind and should be imported from local paths. The Tailwind plugin registers CSS variables, animation keyframes, dark mode tokens, and an optional 3D effect system. A Pro license unlocks premium components, page template blocks, and authenticated CLI and MCP delivery; license keys can also be set through an environment variable for CI/CD. The MCP server is intended for AI coding assistants such as Cursor, Claude, and GitHub Copilot. Through MCP tools, assistants can list and search components, list categories, fetch component source and installation guides, get usage examples, and access Pro blocks when licensed. The README includes configuration examples for Cursor, Windsurf, Claude Desktop, and VS Code integrations. License is MIT for the repository as stated, with separate Pro content. The project also provides auto-configuration for MCP through npx lightswind mcp init. The README warns AI agents not to import from the lightswind package directly and not to reference a provider component or node_modules build output. Overall, it targets React developers who want editable source components and AI-assisted installation workflows.