Portfolio
Portfolio es un "REPL visual" de ClojureScript: renderiza componentes de UI en escenas nombradas y aisladas para que puedas ver cada estado del componente de un vistazo. Es similar a Storybook.js pero diseñado para el desarrollo ClojureScript basado en REPL.
Versión actual: no.cjohansen/portfolio {:mvn/version "2026.03.1"}
Decisión rápida: ¿Qué necesitas?
| Tarea | Ir a |
|---|---|
| Instalar, iniciar la UI, configurar shadow-cljs | setup.md |
Definir escenas con defscene, parámetros, átomos, ciclo de vida | defscene.md |
| Elegir un adaptador de framework (Reagent, React, Replicant…) | defscene.md |
| Organizar escenas en colecciones, carpetas, paquetes | organization.md |
| Personalizar fondo, viewport, grid, CSS, HTML | customize-ui.md |
Usar tap> desde el REPL sin definir una escena | setup.md |
| Deshabilitar Portfolio en builds de producción | setup.md |
| Errores comunes y cosas que evitar | anti-patterns.md |
Modelo mental central
Portfolio renderiza escenas — instantáneas nombradas de un componente en un estado específico. Las escenas viven en namespaces regulares de ClojureScript (típicamente llamados *-scenes), y Portfolio las organiza automáticamente en una barra lateral navegable por jerarquía de namespaces.
defscene → escena → namespace (paquete) → carpeta → barra lateral
La UI se ejecuta en el navegador en la dirección de tu servidor de desarrollo. Reevaluar un defscene en el REPL lo vuelve a renderizar inmediatamente — sin necesidad de recargar la página.
Ejemplo 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 default-button
[:button.btn "Haz clic"])
(defscene disabled-button
[:button.btn {:disabled true} "No puedes hacer clic"])
;; src/my/dev/portfolio.cljs — llama a esto desde tu :runner-ns de shadow-cljs
(ns my.dev.portfolio
(:require [portfolio.ui :as ui]))
(ui/start! {:config {:css-paths ["/css/app.css"]}})
Target de build :portfolio de shadow-cljs
Carga automáticamente todos los namespaces cuyo nombre termina en -scenes. La ruta de configuración más rápida:
;; shadow-cljs.edn
{:deps {:aliases [:dev]}
:dev-http {8080 ["dev-resources/public" "classpath:public"]}
:builds
{:portfolio
{:target :portfolio
:runner-ns my.dev.portfolio ;; omitir para iniciar sin configuración
:dev {:output-dir "dev-resources/public/js"}}}}
"classpath:public" en :dev-http es obligatorio — sirve los recursos empaquetados de Portfolio desde el jar.
Consejos por defecto
- Mantén las escenas en un directorio dedicado (
dev/,scenes/o una ruta de origen de alias:dev) para que nunca se incluyan en builds de producción. - Usa
:paramscuando los datos del componente no sean triviales — permite experimentar en el REPL e indexar para búsqueda. - Prefiere el target
:portfoliode shadow-cljs en lugar de cargar namespaces manualmente para proyectos nuevos. - No suprimas Portfolio en producción mediante flags del compilador si simplemente puedes excluir los namespaces de escenas del build de producción.