re-frame2-setup

Scaffolds greenfield re-frame2 ClojureScript projects with shadow-cljs and a working counter app.

49|Updated May 7, 2026
One-click install
npx skills add https://github.com/day8/re-frame2 --skill re-frame2-setup-day8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: re-frame2-setup
Source: https://github.com/day8/re-frame2/tree/main/skills/re-frame2-setup
Command: npx skills add https://github.com/day8/re-frame2 --skill re-frame2-setup-day8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new re-frame2 ClojureScript project requires correctly wiring deps.edn coordinates, shadow-cljs builds, the Reagent adapter, and an entry namespace — a version-sensitive process where small mistakes surface only as confusing compile errors. This Skill automates the entire bootstrap from an empty directory to a mounted, clickable counter app. ## Core Features & Use Cases - Thirteen-file canonical scaffold: Writes the exact project files the official generator template emits — deps.edn, shadow-cljs.edn, entry namespace with rf/init!, split events/subs/views, a starter test, and Story on the :dev alias. - Skill-executed build verification: Runs npm install, a terminating shadow-cljs compile, and starts the dev watch itself, then reports the actual served URL. - Two bootstrap routes: A manual file-writing route (default) and a generator route that runs clojure -Tnew create with the deps-new template, both landing on the same project. - Use Case: Ask to start a new re-frame2 app in an empty directory; the Skill writes all files, resolves the pre-publication framework coordinates via :local/root, compiles, serves at localhost:8280, and hands off once the counter mounts. ## Quick Start Ask the AI to scaffold a new re-frame2 project in this directory and serve the counter app.

Frequently Asked Questions about re-frame2-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a new re-frame2 ClojureScript project?▼

Invoke the skill with a request like "start a new re-frame2 project". It writes the canonical thirteen-file scaffold, points the framework coordinates at a resolving source, runs npm install and shadow-cljs compile, starts the watch server, and reports the URL.

What is the difference between the re-frame2-setup skill and the re-frame2 template generator?▼

Both produce the same thirteen files. The deps-new template emits them in one clojure -Tnew create command, while the skill writes them step by step with explanations. The skill can also run the generator command itself on request.

Can I scaffold a re-frame2 app with UIx instead of Reagent?▼

Yes, on explicit request. The UIx project is the same thirteen files with four swapped: deps.edn, core.cljs, views.cljs, and stories.cljs. UIx views read subscriptions via use-sub rather than reg-view.

Why does my fresh re-frame2 project fail with "Could not find artifact day8/re-frame2"?▼

re-frame2 is not yet published to Clojars, so the default :mvn/version coordinates do not resolve. Replace them with :local/root paths into a reviewed re-frame2 checkout, or use :git/sha coordinates for core, the adapter, and Story.

When should I not use re-frame2-setup?▼

Do not use it for adding re-frame2 to an existing non-trivial app, writing application code on a working project, live REPL inspection, or v1-to-v2 migration. Those route to the re-frame2, re-frame2-pair, and re-frame-migration skills respectively.

What prerequisites does a re-frame2 scaffold need?▼

Java 21 or newer and the Clojure CLI are required, verified via java -version and clojure -Sdescribe before any files are written. The optional deps-new -Tnew tool is needed only for the generator route.