Communitygithub.com

stoating/clojure-portfolio-skill

À utiliser lorsque vous travaillez avec Portfolio — un REPL visuel ClojureScript pour développer des composants UI de manière isolée. Actif quand l'utilisateur demande defscene, portfolio.ui/start!, la cible de build :portfolio shadow-cljs, l'organisation des scènes, la personnalisation de l'UI (fond/viewport/grille/CSS), les adaptateurs de framework (Reagent, React, Replicant, Rum, Dumdom), les scènes avec état utilisant des atoms, l'utilisation de tap> dans le REPL, ou la désactivation de Portfolio en production.

Qu'est-ce que clojure-portfolio-skill ?

Portfolio est un REPL visuel pour ClojureScript qui permet aux développeurs d'afficher des composants UI dans des 'scènes' nommées et isolées, facilitant ainsi le développement et le débogage de chaque état d'un composant. Contrairement à Storybook.js, il est conçu pour un développement orienté REPL, permettant de réévaluer une scène dans le REPL et de voir la mise à jour immédiatement sans rechargement de page. Il prend en charge plusieurs adaptateurs de framework tels que Reagent, React, Replicant, Rum et Dumdom, et s'intègre parfaitement avec shadow-cljs via une cible de build dédiée `:portfolio` qui charge automatiquement tous les namespaces se terminant par `-scenes`. Cette compétence est utile lors de la création de scènes avec `defscene`, de l'organisation des scènes en collections, de la personnalisation de l'interface (fond, viewport, grille, CSS) et de l'utilisation avancée comme les scènes avec état avec des atoms ou la désactivation de Portfolio en production.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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âcheAller à
Installer, démarrer l'interface, configuration shadow-cljssetup.md
Définir des scènes avec defscene, paramètres, atoms, cycle de viedefscene.md
Choisir un adaptateur de framework (Reagent, React, Replicant…)defscene.md
Organiser les scènes en collections, dossiers, packagesorganization.md
Personnaliser le fond, le viewport, la grille, le CSS, le HTMLcustomize-ui.md
Utiliser tap> depuis le REPL sans définir de scènesetup.md
Désactiver Portfolio dans les builds de productionsetup.md
Erreurs courantes et choses à éviteranti-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 :params dè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 :portfolio au 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.

Skills associés