Communitygithub.com

stoating/clojure-portfolio-skill

Use ao trabalhar com o Portfolio — um REPL visual em ClojureScript para desenvolver componentes de UI isoladamente. Ative quando o usuário perguntar sobre defscene, portfolio.ui/start!, o target de build :portfolio do shadow-cljs, organização de cenas, personalização de UI (fundo/viewport/grid/CSS), adaptadores de framework (Reagent, React, Replicant, Rum, Dumdom), cenas com estado usando átomos, uso do tap> no REPL ou desabilitação do Portfolio em builds de produção.

O que é clojure-portfolio-skill?

Este skill capacita agentes de IA a utilizar o Portfolio, um REPL visual para ClojureScript que renderiza componentes de UI em cenas nomeadas e isoladas, similar ao Storybook.js, mas otimizado para desenvolvimento orientado a REPL. Com ele, o agente pode definir cenas usando `defscene`, organizá-las em namespaces e pastas, personalizar a aparência (fundo, viewport, grid, CSS) e escolher entre adaptadores de frameworks como Reagent, React e Replicant. O skill suporta o target de build `:portfolio` do shadow-cljs, que carrega automaticamente todos os namespaces que terminam em `-scenes`, e permite uso direto do `tap>` no REPL para inspecionar componentes sem criar uma cena. É útil para desenvolvedores que desejam iterar rapidamente sobre componentes de UI, testar diferentes estados e integrar com fluxos de desenvolvimento REPL-driven, além de fornecer orientações para evitar armadilhas comuns e desabilitar o Portfolio em produção.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stoating/clojure-portfolio-skill/tree/HEAD/skills/portfolio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portfolio

Portfolio é um "REPL visual" para ClojureScript — ele renderiza componentes de UI em cenas nomeadas e isoladas para que você possa ver cada estado do componente de relance. É semelhante ao Storybook.js, mas projetado para o desenvolvimento ClojureScript orientado a REPL.

Versão atual: no.cjohansen/portfolio {:mvn/version "2026.03.1"}

Decisão Rápida: O que você precisa?

TarefaIr para
Instalar, iniciar a UI, configurar shadow-cljssetup.md
Definir cenas com defscene, parâmetros, átomos, ciclo de vidadefscene.md
Escolher um adaptador de framework (Reagent, React, Replicant…)defscene.md
Organizar cenas em coleções, pastas, pacotesorganization.md
Personalizar fundo, viewport, grade, CSS, HTMLcustomize-ui.md
Usar tap> do REPL sem definir uma cenasetup.md
Desabilitar o Portfolio em builds de produçãosetup.md
Erros comuns e coisas a evitaranti-patterns.md

Modelo Mental Principal

O Portfolio renderiza cenas — instantâneos nomeados de um componente em um estado específico. As cenas vivem em namespaces regulares de ClojureScript (normalmente nomeados como *-scenes), e o Portfolio as organiza automaticamente em uma barra lateral navegável pela hierarquia de namespaces.

defscene → cena → namespace (pacote) → pasta → barra lateral

A UI é executada no navegador no endereço do seu servidor de desenvolvimento. Reavaliar um defscene no REPL o renderiza imediatamente — sem necessidade de recarregar a página.

Exemplo Mínimo Funcional

;; deps.edn
{:deps {no.cjohansen/portfolio {:mvn/version "2026.03.1"}}}
;; src/my/button_scenes.cljs
(ns my.button-scenes
  (:require [portfolio.reagent :refer-macros [defscene]]))

(defscene botao-padrao
  [:button.btn "Clique aqui"])

(defscene botao-desabilitado
  [:button.btn {:disabled true} "Não pode clicar"])
;; src/my/dev/portfolio.cljs  — chame isso do seu :runner-ns do shadow-cljs
(ns my.dev.portfolio
  (:require [portfolio.ui :as ui]))

(ui/start! {:config {:css-paths ["/css/app.css"]}})

Target de Build :portfolio do shadow-cljs

Carrega automaticamente todos os namespaces cujo nome termina em -scenes. O caminho de configuração mais rápido:

;; shadow-cljs.edn
{:deps {:aliases [:dev]}
 :dev-http {8080 ["dev-resources/public" "classpath:public"]}
 :builds
 {:portfolio
  {:target :portfolio
   :runner-ns my.dev.portfolio    ;; omita para iniciar sem configuração
   :dev {:output-dir "dev-resources/public/js"}}}}

"classpath:public" em :dev-http é obrigatório — ele serve os ativos empacotados do Portfolio a partir do jar.

Recomendações Padrão

  • Mantenha as cenas em um diretório dedicado (dev/, scenes/ ou um caminho de fonte com alias :dev) para que nunca sejam incluídas em builds de produção.
  • Use :params sempre que os dados do componente não forem triviais — isso permite experimentação no REPL e indexação de busca.
  • Prefira o target :portfolio do shadow-cljs em vez de carregar namespaces manualmente para novos projetos.
  • Não desabilite o Portfolio em produção via flags do compilador se você puder simplesmente excluir os namespaces de cena do build de produção.

Habilidades Relacionadas