프로젝트 소개

Lightswind UI는 README가 영어로 작성된 React 컴포넌트 라이브러리입니다. 이 라이브러리는 소스 코드 배포 모델을 사용하여, 런타임 패키지에서 가져오는 대신 Lightswind CLI를 통해 사용자의 프로젝트에 컴포넌트를 설치합니다. 프로젝트는 3D 요소, 배경, 고급 컴포넌트, 버튼, 텍스트 효과, 커서 효과, UI 코어, 폼 컨트롤, 레이아웃/내비게이션 등의 카테고리로 분류된 160개 이상의 애니메이션 및 접근성 컴포넌트를 제공합니다. 요구 사항으로는 Node.js 18 이상, React 18 또는 19, Tailwind CSS v3 또는 v4, 그리고 Next.js, Vite, Remix 또는 CRA 프로젝트가 필요합니다. CLI는 init, add, list, Pro 인증 및 MCP 명령을 지원합니다. 또한 프레임워크를 감지하고, 컴포넌트 전제 조건을 해결하며, 공유 유틸리티를 설치하고 Tailwind 플러그인을 등록합니다. README에 따르면 컴포넌트는 components/lightswind에 위치하며 로컬 경로에서 임포트해야 합니다. Tailwind 플러그인은 CSS 변수, 애니메이션 키프레임, 다크 모드 토큰 및 선택적 3D 효과 시스템을 등록합니다. Pro 라이선스를 통해 프리미엄 컴포넌트, 페이지 템플릿 블록, 인증된 CLI 및 MCP 전달 기능을 사용할 수 있으며, CI/CD를 위해 환경 변수로 라이선스 키를 설정할 수 있습니다. MCP 서버는 Cursor, Claude, GitHub Copilot과 같은 AI 코딩 어시스턴트를 위해 설계되었습니다. MCP 도구를 통해 어시스턴트는 컴포넌트 목록 조회 및 검색, 카테고리 확인, 컴포넌트 소스 및 설치 가이드 가져오기, 사용 예시 확인, 라이선스 보유 시 Pro 블록 접근 등이 가능합니다. README에는 Cursor, Windsurf, Claude Desktop 및 VS Code 통합을 위한 설정 예시가 포함되어 있습니다. 저장소 라이선스는 MIT이며, Pro 콘텐츠는 별도로 운영됩니다. 또한 npx lightswind mcp init을 통해 MCP 자동 설정을 제공합니다. README는 AI 에이전트가 lightswind 패키지에서 직접 임포트하거나 provider 컴포넌트 또는 node_modules 빌드 출력물을 참조하지 말 것을 경고합니다. 전반적으로 이 프로젝트는 편집 가능한 소스 컴포넌트와 AI 지원 설치 워크플로우를 원하는 React 개발자를 대상으로 합니다.