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?
| Aufgabe | Gehe zu |
|---|---|
| Installation, UI starten, shadow-cljs Einrichtung | setup.md |
Szenen definieren mit defscene, Parametern, Atoms, Lebenszyklus | defscene.md |
| Einen Framework-Adapter wählen (Reagent, React, Replicant…) | defscene.md |
| Szenen in Sammlungen, Ordnern und Paketen organisieren | organization.md |
| Hintergrund, Viewport, Gitter, CSS, HTML anpassen | customize-ui.md |
tap> aus der REPL verwenden, ohne eine Szene zu definieren | setup.md |
| Portfolio in Produktions-Builds deaktivieren | setup.md |
| Häufige Fehler und Dinge, die vermieden werden sollten | anti-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
:portfolioshadow-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.