Dashcraft

A ClojureScript component library using replicant with a development environment powered by shadow-cljs and Portfolio for component development and visualization.

Prerequisites

• Clojure CLI (for deps.edn dependencies)
• Babashka
• Bun (for JavaScript dependencies)

Development

Starting the REPL

bb dev

This starts an nREPL with shadow-cljs middleware. Connect your editor, then in the REPL:

(start!)       ; start shadow-cljs + portfolio on http://localhost:3000
(stop!)        ; stop shadow-cljs
(cljs-repl!)   ; connect to browser CLJS REPL (exit with :cljs/quit)

Standalone watch (no REPL)

bb watch

Tests

bb test           # run RCT tests
bb watch-tests    # re-run on file changes

Other tasks

bb outdated    # show outdated dependencies
bb clean       # remove build artifacts

Component Development with Portfolio

Component examples and demos are managed through Portfolio. Add your component examples in the portfolio/ directory to see them at http://localhost:3000.

Project Structure

.
├── src/          # Core ClojureScript source files
├── portfolio/    # Component examples and demos (Portfolio scenes)
├── dev/          # REPL helpers (user.clj)
└── resources/    # Static assets and public files