Visual and Interactive Syntax realized (VISr) for ClojureScript

This is a very early prototype of Visual and Interactive Syntax for ClojureScript. Feel free to look around, but things will change and others will be broken.

Live Tool (Prototype)

To run VISr for ClojureScript, you only need a browser. We currently provide an early prototype at:

visr.pl

Proper documentation coming soon. For now, you can create a visr with:

(defvisr VisrName
  (elaborate [this] 42)
  (render [this] [:button "hello"]))

Additionally, build in support is provided for:

• reagent
• garden
• react-bootstrap

And a list of additional dependencies can be found on this github page. Proper documentation on how to create new dependencies to come.

Build Requirements

Building VISr require both NPM and Clojure. You can either obtain them yourself, or use Nix to download them for you.

Automatically Install Dependencies with Nix (Mac/Linux Only)

Note: If you don't have it yet, you'll need the Nix build tool. You can install it with:

curl -L https://nixos.org/nix/install | sh

Simply cd into the project directory and run:

nix-shell

You should now be in a shell environment with both NPM and Clojure.

Manually Install Dependencies

1. First, download Java and Clojure for your operating system.
2. Next, download Node.js for your operating system, it comes with NPM.
3. Finally, cd into the project folder and run npm ci.

You should now be ready to build VISr for ClojureScript.

Build & Test VISr

Development mode

To start the Figwheel compiler, navigate to the project folder and run the following command in the terminal:

clojure -M:fig

Figwheel will automatically push cljs changes to the browser. Once Figwheel starts up, you should be able to open localhost:9500 in the browser.

Once the page is open, a REPL should be usable from your terminal.

Tests

With a development build running, open localhost:9500/figwheel-extra-main/auto-testing in the browser.

Building for production

clojure -M:package

Then go get a coffee, a production build seems to take about 5 minutes.