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?
| Tarefa | Ir para |
|---|---|
| Instalar, iniciar a UI, configurar shadow-cljs | setup.md |
Definir cenas com defscene, parâmetros, átomos, ciclo de vida | defscene.md |
| Escolher um adaptador de framework (Reagent, React, Replicant…) | defscene.md |
| Organizar cenas em coleções, pastas, pacotes | organization.md |
| Personalizar fundo, viewport, grade, CSS, HTML | customize-ui.md |
Usar tap> do REPL sem definir uma cena | setup.md |
| Desabilitar o Portfolio em builds de produção | setup.md |
| Erros comuns e coisas a evitar | anti-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
:paramssempre que os dados do componente não forem triviais — isso permite experimentação no REPL e indexação de busca. - Prefira o target
:portfoliodo 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.