
refy-local
Local Refy MCP server with screenshot comparison to reproduce existing screens faithfully.
- GitHub stars
- 10
What it does
- Adds the
refy-tela,refy-tema-de-site,refy-pagina-solta, andrefy-reproduzir-telaskills plus an MCP server configured in.mcp.json - Covers screen and theme work from your machine: building components, extracting a site's theme, and making standalone HTML pages
- Reproduces a screen only when asked, then compares both captures with
refy_compareuntil they match - Runs
refy_validateagainst the installed TypeScript API and reads only your project files, calling the network only for site theme extraction
Servidor do Refy na sua máquina e o atalho para reproduzir uma tela igual ao original, com comparação de capturas.
Add marketplace
/plugin marketplace add viniciuscoimbra/refy-designRun it inside Claude Code once, then install the plugin below.
Install
/plugin install refy-local@refyRun it inside Claude Code after adding the marketplace.
Files
Discovered from sourcePágina HTML solta com Refy
Use as ferramentas do servidor MCP refy. Responda na língua da pessoa.
Fluxo
- Base. Parta do HTML da página Sem bundler. É o mesmo HTML que o refy testa no navegador depois de cada versão. Mantenha os quatro
<link>(tokens.css,fonts.css,global.css,style.css) e o trecho que lê o endereço do React dentro do/+esmdo refy: com outro endereço a página carrega duas cópias do React e quebra. A versão é a da página ou a denpm view @refy-design/web version, igual em todos os endereços. - Escolha. Para cada parte da página, chame
refy_searchcom a necessidade ("indicador com variação", "tabela de pedidos"). Leiaalternativese use a família indicada. - API. Chame
refy_componentpara cada família. Use só as props que a ficha documenta, nos valores que ela aceita. - Código. Sem build não há JSX: monte a árvore com
createElement(hno trecho) e importe os componentes do mesmoimport(refy). Cor, fonte, raio e sombra vêm do tema: nada de hexadecimal,rgb(),font-familynem<style>com cor. Layout (grid, gap, largura) pode ir nostylecom tokens, comovar(--space-6). - Conferência.
refy_validatelê JSX e não confere chamadas decreateElement. Passe emcodea mesma árvore escrita em JSX, comfilenamePagina.jsx, as mesmas props e o mesmostyle. Corrija cada erro na página e no JSX e rode de novo atépassed: truecom as famílias usadas emcomponents. - Entrega. Se tiver navegador, abra a página, confira o console sem erro e mostre a tela. Diga em uma linha as famílias usadas e o resultado da conferência.
O que não fazer
- Não troque o React do trecho por outro endereço nem por
react@18fixo. - Não copie a paleta ou as fontes do tema para CSS da página: o
tokens.cssjá traz. - Não recrie um componente que o Refy já tem; se faltar algum, diga qual.
- Não esconda erro da conferência: se um ficar, diga qual e por quê.
Readme
Plugin refy-local
Roda o servidor MCP do Refy na sua máquina, com os atalhos refy-tela, refy-tema-de-site e refy-pagina-solta do plugin refy e mais refy-reproduzir-tela: só quando você pede, reproduz a tela igual ao original com componentes do Refy e extensões, e compara as duas capturas com refy_compare até bater.
Para telas e temas no dia a dia, o plugin refy (servidor remoto, sem instalar nada) basta. Use este no lugar dele quando quiser conferir os arquivos do projeto com o TypeScript instalado ou comparar capturas.
Precisa de Node.js 20 ou mais novo, sem conta e sem chave.
/plugin marketplace add viniciuscoimbra/refy-design
/plugin install refy-local@refy
No Codex: codex plugin add refy-local@refy depois de adicionar o mesmo marketplace.
O que o plugin roda e o que envia
npx baixa @refy-design/web na versão exata do plugin (1.11.0) do registro do npm e roda o comando refy-mcp do pacote. Esse servidor:
- lê o catálogo e a fundação de tokens que vêm no pacote;
- não escreve no projeto e não chama IA; só grava a imagem de diferença do
refy_compare, na pasta temporária do sistema; - do projeto, lê o TypeScript instalado (em toda conferência), os arquivos que você passa em
refy_validatecomrefy-agent.config.json,theme.jsone o registro de pranchas, as imagens que você passa emrefy_comparee o Playwright instalado, quandorefy_theme_extractabre um site; - só fala com a rede em
refy_theme_extractcomurl: lê a página indicada e as folhas de estilo que ela carrega (até 12, inclusive de outros domínios). Endereço interno (localhost, rede privada) é recusado.
Privacidade: PRIVACY.md. Suporte: issues do refy-design. Licença Apache 2.0.
Details
- Marketplace
- viniciuscoimbra/refy-design
- Source
- plugins/refy-local
- Category
- Design
More from viniciuscoimbra/refy-design
All 2Similar to refy-local
More Design & Creative
example-skillsanthropics/skills196.9K starsCollection of example skills demonstrating various capabilities including skill creation, MCP building, visual design, algorithmic art, internal communications,
feature-devanthropics/claude-code156.1K starsComprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
ui-ux-pro-maxnextlevelbuilder/ui-ux-pro-max-skill152.6K starsProfessional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for Reac
taste-skillLeonxlnx/taste-skill117.9K starstasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept fo
impeccablepbakaus/impeccable114.7K starsDesign fluency for frontend development. 1 skill with 24 commands (/impeccable polish, /impeccable audit, /impeccable critique, etc.) and curated anti-pattern d
storybookstorybookjs/storybook91.6K starsBuild, preview, and test UI components with Storybook.