Portfolio
Portfolio는 ClojureScript "시각적 REPL"입니다. UI 컴포넌트를 이름이 지정된 개별 **씬(scene)**으로 렌더링하여 모든 컴포넌트 상태를 한눈에 볼 수 있습니다. Storybook.js와 비슷하지만 REPL 중심의 ClojureScript 개발을 위해 설계되었습니다.
현재 릴리스: no.cjohansen/portfolio {:mvn/version "2026.03.1"}
빠른 결정: 무엇이 필요하신가요?
| 작업 | 이동 위치 |
|---|---|
| 설치, UI 시작, shadow-cljs 설정 | setup.md |
defscene, params, atoms, 라이프사이클로 씬 정의 | 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 → scene → namespace (package) → folder → sidebar
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/또는:devalias 소스 경로)에 보관하여 프로덕션 빌드에 포함되지 않도록 하세요. - 컴포넌트 데이터가 복잡하다면
:params를 사용하세요. REPL 조작과 검색 인덱싱이 가능해집니다. - 새 프로젝트에서는 수동 네임스페이스 로딩보다
:portfolioshadow-cljs 대상을 선호하세요. - 컴파일러 플래그로 Portfolio를 프로덕션에서 억제하지 말고, 대신 씬 네임스페이스를 프로덕션 빌드에서 제외하는 방식이 더 좋습니다.