@fluencypassdevs/cycle
v1.5.1
Published
Cycle Design System — UI component library by Fluencypass
Downloads
4,033
Readme
Cycle Design System
Design System da Fluencypass, construido sobre shadcn/ui + Next.js 16 + Tailwind CSS 4.
Instalacao
npm install @fluencypassdevs/cycle geistNo src/app/layout.tsx, configurar a fonte Geist:
import { GeistSans } from "geist/font/sans"
import { GeistMono } from "geist/font/mono"
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="pt-BR" className={`${GeistSans.variable} ${GeistMono.variable}`}>
<body>{children}</body>
</html>
)
}No globals.css:
@import "tailwindcss";
@import "@fluencypassdevs/cycle/styles.css";import { Button, Badge, CycleIcon } from "@fluencypassdevs/cycle"Configurar IA (Claude Code, Cursor, Copilot)
npx cycle initEsse comando:
- Adiciona regras do Cycle ao seu
CLAUDE.md,.cursorrulese outros spec-kits (preserva regras existentes) - Cria
.mcp.jsonpara Claude Code — habilita 6 tools do Cycle (buscar componentes, tokens, regras)
MCP Server (Claude Code)
O init configura automaticamente o MCP server. O Claude Code passa a ter acesso a:
| Tool | Funcao |
|------|--------|
| cycle_search_component | Busca componentes por nome/keyword |
| cycle_get_component | Detalhes completos (props, exemplos) |
| cycle_get_icon_usage | Regras de uso de icones |
| cycle_get_setup | Instrucoes de setup |
| cycle_get_tokens | Tokens semanticos disponiveis |
| cycle_get_rules | Regras obrigatorias para IA |
Isso garante que a IA consulte os componentes existentes antes de gerar codigo, em vez de depender apenas de instrucoes estaticas.
Documentacao
- Setup Guide: https://cycle-design.fluencypass.com/docs
- Componentes: https://cycle-design.fluencypass.com/docs/components
- Tokens: https://cycle-design.fluencypass.com/docs/tokens
Desenvolvimento
npm run dev # servidor de desenvolvimento
npm run build # build de producao (Next.js)
npm run build:lib # build do pacote npm
npm run lint # ESLintStack
- Next.js 16 (App Router)
- React 19
- TypeScript 5
- Tailwind CSS 4
- shadcn/ui (new-york style)
- Radix UI primitives
- Lucide React icons
