Communitygithub.com

stoating/clojure-portfolio-skill

Úsalo al trabajar con Portfolio — un REPL visual de ClojureScript para desarrollar componentes de UI de forma aislada. Actívalo cuando el usuario pregunte sobre defscene, portfolio.ui/start!, el target de build :portfolio de shadow-cljs, organización de escenas, personalización de la interfaz (fondo/viewport/grid/CSS), adaptadores de frameworks (Reagent, React, Replicant, Rum, Dumdom), escenas con estado usando átomos, uso de tap> en el REPL o cómo deshabilitar Portfolio en builds de producción.

¿Qué es clojure-portfolio-skill?

Portfolio es un REPL visual para ClojureScript, similar a Storybook.js pero diseñado para el desarrollo basado en REPL. Permite renderizar componentes de UI en **escenas** nombradas y aisladas, mostrando cada estado posible del componente de un vistazo. El skill cubre la instalación, configuración con shadow-cljs, definición de escenas mediante `defscene`, organización en colecciones y carpetas, personalización de la apariencia (fondo, viewport, grid, CSS), adaptadores para frameworks como Reagent, React, Replicant, Rum y Dumdom, manejo de estado con átomos, uso de `tap>` desde el REPL sin necesidad de definir una escena, y buenas prácticas para evitar incluir Portfolio en builds de producción. Es compatible con proyectos ClojureScript que usen shadow-cljs y se integra de forma natural con el flujo de trabajo REPL para una retroalimentación instantánea.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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?

TareaIr a
Instalar, iniciar la UI, configurar shadow-cljssetup.md
Definir escenas con defscene, parámetros, átomos, ciclo de vidadefscene.md
Elegir un adaptador de framework (Reagent, React, Replicant…)defscene.md
Organizar escenas en colecciones, carpetas, paquetesorganization.md
Personalizar fondo, viewport, grid, CSS, HTMLcustomize-ui.md
Usar tap> desde el REPL sin definir una escenasetup.md
Deshabilitar Portfolio en builds de producciónsetup.md
Errores comunes y cosas que evitaranti-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 :params cuando los datos del componente no sean triviales — permite experimentar en el REPL e indexar para búsqueda.
  • Prefiere el target :portfolio de 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.

Skills relacionados