New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Local Refy MCP server with screenshot comparison to reproduce existing screens faithfully.

GitHub stars
10
View on GitHub

What it does

  • Adds the refy-tela, refy-tema-de-site, refy-pagina-solta, and refy-reproduzir-tela skills 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_compare until they match
  • Runs refy_validate against 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-design

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install refy-local@refy

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Página HTML solta com Refy

Use as ferramentas do servidor MCP refy. Responda na língua da pessoa.

Fluxo

  1. 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 /+esm do 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 de npm view @refy-design/web version, igual em todos os endereços.
  2. Escolha. Para cada parte da página, chame refy_search com a necessidade ("indicador com variação", "tabela de pedidos"). Leia alternatives e use a família indicada.
  3. API. Chame refy_component para cada família. Use só as props que a ficha documenta, nos valores que ela aceita.
  4. Código. Sem build não há JSX: monte a árvore com createElement (h no trecho) e importe os componentes do mesmo import(refy). Cor, fonte, raio e sombra vêm do tema: nada de hexadecimal, rgb(), font-family nem <style> com cor. Layout (grid, gap, largura) pode ir no style com tokens, como var(--space-6).
  5. Conferência. refy_validate lê JSX e não confere chamadas de createElement. Passe em code a mesma árvore escrita em JSX, com filename Pagina.jsx, as mesmas props e o mesmo style. Corrija cada erro na página e no JSX e rode de novo até passed: true com as famílias usadas em components.
  6. 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@18 fixo.
  • Não copie a paleta ou as fontes do tema para CSS da página: o tokens.css já 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_validate com refy-agent.config.json, theme.json e o registro de pranchas, as imagens que você passa em refy_compare e o Playwright instalado, quando refy_theme_extract abre um site;
  • só fala com a rede em refy_theme_extract com url: 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 2

Similar to refy-local

More Design & Creative