Portfolio
Portfolio est un "REPL visuel" pour ClojureScript — il affiche des composants UI dans des scènes nommées et isolées, vous permettant de voir chaque état d'un composant en un coup d'œil. Il est similaire à Storybook.js mais conçu pour le développement ClojureScript piloté par REPL.
Version actuelle : no.cjohansen/portfolio {:mvn/version "2026.03.1"}
Décision rapide : De quoi avez-vous besoin ?
| Tâche | Aller à |
|---|---|
| Installer, démarrer l'interface, configuration shadow-cljs | setup.md |
Définir des scènes avec defscene, paramètres, atoms, cycle de vie | defscene.md |
| Choisir un adaptateur de framework (Reagent, React, Replicant…) | defscene.md |
| Organiser les scènes en collections, dossiers, packages | organization.md |
| Personnaliser le fond, le viewport, la grille, le CSS, le HTML | customize-ui.md |
Utiliser tap> depuis le REPL sans définir de scène | setup.md |
| Désactiver Portfolio dans les builds de production | setup.md |
| Erreurs courantes et choses à éviter | anti-patterns.md |
Modèle mental central
Portfolio rend des scènes — des instantanés nommés d'un composant dans un état spécifique. Les scènes vivent dans des namespaces ClojureScript classiques (généralement nommés *-scenes), et Portfolio les organise automatiquement dans une barre latérale navigable par hiérarchie de namespace.
defscene → scène → namespace (package) → dossier → barre latérale
L'interface s'exécute dans le navigateur à l'adresse de votre serveur de développement. Réévaluer une defscene dans le REPL la réaffiche immédiatement — aucun rafraîchissement de page nécessaire.
Exemple minimal fonctionnel
;; 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 "Cliquez moi"])
(defscene disabled-button
[:button.btn {:disabled true} "Impossible de cliquer"])
;; src/my/dev/portfolio.cljs — appelez cela depuis votre :runner-ns shadow-cljs
(ns my.dev.portfolio
(:require [portfolio.ui :as ui]))
(ui/start! {:config {:css-paths ["/css/app.css"]}})
Cible de build shadow-cljs :portfolio
Charge automatiquement tous les namespaces dont le nom se termine par -scenes. Le chemin d'installation le plus rapide :
;; shadow-cljs.edn
{:deps {:aliases [:dev]}
:dev-http {8080 ["dev-resources/public" "classpath:public"]}
:builds
{:portfolio
{:target :portfolio
:runner-ns my.dev.portfolio ;; omettre pour démarrer sans configuration
:dev {:output-dir "dev-resources/public/js"}}}}
"classpath:public" dans :dev-http est obligatoire — il sert les ressources groupées de Portfolio depuis le jar.
Conseils par défaut
- Conservez les scènes dans un répertoire dédié (
dev/,scenes/, ou un chemin source d'alias:dev) afin qu'elles ne soient jamais incluses dans les builds de production. - Utilisez
:paramsdès que les données du composant sont non triviales — cela permet le bricolage dans le REPL et l'indexation de recherche. - Préférez la cible shadow-cljs
:portfolioau chargement manuel des namespaces pour les nouveaux projets. - Ne désactivez pas Portfolio en production via des drapeaux de compilation si vous pouvez simplement exclure les namespaces de scènes du build de production à la place.