Communitygithub.com

stoating/clojure-portfolio-skill

Portfolio — ClojureScript 시각적 REPL을 사용하여 UI 컴포넌트를 개별적으로 개발할 때 활용합니다. defscene, portfolio.ui/start!, :portfolio shadow-cljs 빌드 대상, 씬 구성, UI 커스터마이징(배경/뷰포트/그리드/CSS), 프레임워크 어댑터(Reagent, React, Replicant, Rum, Dumdom), 상태를 가진 씬에서의 atoms, tap> REPL 사용법, 프로덕션 빌드에서 Portfolio 비활성화 등과 관련된 사용자 요청 시 활성화합니다.

clojure-portfolio-skill란 무엇인가요?

Portfolio는 Storybook.js와 유사하지만 REPL 기반 ClojureScript 개발에 최적화된 시각적 REPL 도구입니다. 개발자는 `defscene` 매크로를 사용하여 UI 컴포넌트의 다양한 상태를 개별적인 **씬(scene)**으로 정의하고, 이를 브라우저에서 한눈에 확인할 수 있습니다. Reagent, React, Replicant, Rum, Dumdom 등 여러 프레임워크 어댑터를 지원하며, `shadow-cljs`의 `:portfolio` 빌드 대상을 통해 자동으로 씬을 로드하고 사이드바에 네임스페이스 계층 구조로 정리해줍니다. REPL에서 씬을 재평가하면 페이지 새로고침 없이 즉시 UI가 업데이트되어 반응형 개발 워크플로우를 제공합니다. 배경, 뷰포트, 그리드, CSS 등의 UI 요소를 커스터마이징할 수 있고, `tap>`을 활용한 REPL 디버깅, 프로덕션 빌드에서의 제외 설정까지 폭넓은 기능을 갖추고 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stoating/clojure-portfolio-skill/tree/HEAD/skills/portfolio

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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/ 또는 :dev alias 소스 경로)에 보관하여 프로덕션 빌드에 포함되지 않도록 하세요.
  • 컴포넌트 데이터가 복잡하다면 :params를 사용하세요. REPL 조작과 검색 인덱싱이 가능해집니다.
  • 새 프로젝트에서는 수동 네임스페이스 로딩보다 :portfolio shadow-cljs 대상을 선호하세요.
  • 컴파일러 플래그로 Portfolio를 프로덕션에서 억제하지 말고, 대신 씬 네임스페이스를 프로덕션 빌드에서 제외하는 방식이 더 좋습니다.

관련 스킬