Communitygithub.com

stoating/clojure-portfolio-skill

Verwenden Sie dies, wenn Sie mit Portfolio arbeiten – einer ClojureScript Visual REPL zur Entwicklung von UI-Komponenten in Isolation. Aktivieren Sie dies, wenn der Benutzer nach defscene, portfolio.ui/start!, dem :portfolio shadow-cljs Build-Ziel, der Organisation von Szenen, UI-Anpassung (Hintergrund/Viewport/Gitter/CSS), Framework-Adaptern (Reagent, React, Replicant, Rum, Dumdom), zustandsbehafteten Szenen mit Atoms, tap>-REPL-Nutzung oder dem Deaktivieren von Portfolio in Produktions-Builds fragt.

Was ist clojure-portfolio-skill?

Portfolio ist ein visuelles REPL für ClojureScript, das UI-Komponenten in isolierten, benannten Szenen rendert – ähnlich wie Storybook.js, aber speziell für die REPL-getriebene Entwicklung in ClojureScript konzipiert. Es ermöglicht Entwicklern, jeden Komponentenzustand auf einen Blick zu sehen, ohne die Seite neu laden zu müssen. Das Tool unterstützt mehrere Framework-Adapter wie Reagent, React, Replicant, Rum und Dumdom und bietet eine automatische Organisation der Szenen basierend auf der Namespace-Hierarchie. Diese Fertigkeit hilft bei der Installation, Definition von Szenen mit `defscene`, der Verwendung des `:portfolio` shadow-cljs Build-Ziels, der Anpassung der UI (Hintergrund, Viewport, Gitter, CSS) und dem Einsatz von `tap>` aus der REPL, um schnell Komponenten zu testen. Die Dokumentation enthält auch Richtlinien zur Deaktivierung von Portfolio in Produktions-Builds und zur Vermeidung typischer Fehler.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio

Portfolio ist ein ClojureScript „visuelles REPL“ – es rendert UI-Komponenten in benannten, isolierten Szenen, sodass Sie jeden Komponentenzustand auf einen Blick sehen können. Es ähnelt Storybook.js, ist aber für die REPL-gesteuerte ClojureScript-Entwicklung konzipiert.

Aktuelle Version: no.cjohansen/portfolio {:mvn/version "2026.03.1"}

Schnellentscheidung: Was brauchen Sie?

AufgabeGehe zu
Installation, UI starten, shadow-cljs Einrichtungsetup.md
Szenen definieren mit defscene, Parametern, Atoms, Lebenszyklusdefscene.md
Einen Framework-Adapter wählen (Reagent, React, Replicant…)defscene.md
Szenen in Sammlungen, Ordnern und Paketen organisierenorganization.md
Hintergrund, Viewport, Gitter, CSS, HTML anpassencustomize-ui.md
tap> aus der REPL verwenden, ohne eine Szene zu definierensetup.md
Portfolio in Produktions-Builds deaktivierensetup.md
Häufige Fehler und Dinge, die vermieden werden solltenanti-patterns.md

Zentrales Gedankenmodell

Portfolio rendert Szenen – benannte Schnappschüsse einer Komponente in einem bestimmten Zustand. Szenen leben in regulären ClojureScript-Namespaces (normalerweise mit dem Namen *-scenes), und Portfolio organisiert sie automatisch in einer navigierbaren Seitenleiste nach Namespace-Hierarchie.

defscene → szene → namespace (paket) → ordner → seitenleiste

Die UI läuft im Browser unter Ihrer Entwicklungs-Server-Adresse. Das erneute Auswerten einer defscene im REPL rendert sie sofort neu – kein Seitenneuladen erforderlich.

Minimales Arbeitsbeispiel

;; 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 "Click me"])

(defscene disabled-button
  [:button.btn {:disabled true} "Can't click"])
;; src/my/dev/portfolio.cljs  — rufen Sie dies von Ihrem shadow-cljs :runner-ns auf
(ns my.dev.portfolio
  (:require [portfolio.ui :as ui]))

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

shadow-cljs :portfolio Build-Ziel

Lädt automatisch jeden Namespace, dessen Name auf -scenes endet. Der schnellste Einrichtungsweg:

;; shadow-cljs.edn
{:deps {:aliases [:dev]}
 :dev-http {8080 ["dev-resources/public" "classpath:public"]}
 :builds
 {:portfolio
  {:target :portfolio
   :runner-ns my.dev.portfolio    ;; weglassen, um ohne Konfiguration zu starten
   :dev {:output-dir "dev-resources/public/js"}}}}

"classpath:public" in :dev-http ist erforderlich – es dient Portfolios gebündelte Ressourcen aus der Jar-Datei aus.

Standardempfehlungen

  • Halten Sie Szenen in einem dedizierten Verzeichnis (dev/, scenes/ oder einem :dev-Alias-Quellpfad), damit sie nie in Produktions-Builds eingeschlossen werden.
  • Verwenden Sie :params, wenn die Komponentendaten nicht trivial sind – dies ermöglicht REPL-Experimente und Suchindizierung.
  • Bevorzugen Sie das :portfolio shadow-cljs-Ziel gegenüber manuellem Namespace-Laden für neue Projekte.
  • Unterdrücken Sie Portfolio nicht in der Produktion über Compiler-Flags, wenn Sie die Szenen-Namespaces einfach aus dem Produktions-Build ausschließen können.

Verwandte Skills