Portfolio
PortfolioはClojureScriptの「ビジュアルREPL」です。名前付きの独立したシーンとしてUIコンポーネントをレンダリングし、すべてのコンポーネント状態を一目で確認できます。Storybook.jsに似ていますが、REPL駆動のClojureScript開発向けに設計されています。
現在のリリース: no.cjohansen/portfolio {:mvn/version "2026.03.1"}
クイック決定: 何が必要ですか?
| タスク | 参照先 |
|---|---|
| インストール、UIの起動、shadow-cljsのセットアップ | setup.md |
defscene、パラメータ、アトム、ライフサイクルを使ったシーンの定義 | defscene.md |
| フレームワークアダプターの選択(Reagent、React、Replicant…) | defscene.md |
| シーンをコレクション、フォルダ、パッケージに整理 | organization.md |
| 背景、ビューポート、グリッド、CSS、HTMLのカスタマイズ | customize-ui.md |
シーンを定義せずにREPLからtap>を使用 | setup.md |
| プロダクションビルドでPortfolioを無効化 | setup.md |
| よくある間違いと避けるべきこと | anti-patterns.md |
コアメンタルモデル
Portfolioはシーンをレンダリングします。シーンとは、特定の状態にあるコンポーネントの名前付きスナップショットです。シーンは通常のClojureScript名前空間(通常は*-scenesという名前)に配置され、Portfolioは名前空間階層に基づいて自動的にナビゲーション可能なサイドバーに整理します。
defscene → シーン → 名前空間(パッケージ) → フォルダ → サイドバー
UIは開発サーバーのアドレスでブラウザ上で実行されます。REPLでdefsceneを再評価すると、ページのリフレッシュなしで即座に再レンダリングされます。
最小限の動作例
;; 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 — これをshadow-cljsの:runner-nsから呼び出す
(ns my.dev.portfolio
(:require [portfolio.ui :as ui]))
(ui/start! {:config {:css-paths ["/css/app.css"]}})
shadow-cljs :portfolio ビルドターゲット
名前が-scenesで終わるすべての名前空間を自動的に読み込みます。最も高速なセットアップ手順:
;; shadow-cljs.edn
{:deps {:aliases [:dev]}
:dev-http {8080 ["dev-resources/public" "classpath:public"]}
:builds
{:portfolio
{:target :portfolio
:runner-ns my.dev.portfolio ;; 省略すると設定なしで開始
:dev {:output-dir "dev-resources/public/js"}}}}
:dev-httpの"classpath:public"は必須です。これにより、Portfolioのバンドルアセットがjarから提供されます。
デフォルトの推奨事項
- シーンは専用のディレクトリ(
dev/、scenes/、または:devエイリアスのソースパス)に配置し、プロダクションビルドに含まれないようにします。 - コンポーネントデータが複雑な場合は常に
:paramsを使用してください。REPLでの実験や検索インデックス作成が可能になります。 - 新しいプロジェクトでは、手動の名前空間読み込みよりも
:portfolioshadow-cljsターゲットを優先してください。 - プロダクションビルドからシーン名前空間を除外できる場合は、コンパイラフラグでPortfolioを抑制しないでください。