-*- mode: markdown; mode: visual-line; mode: adaptive-wrap-prefix; -*-
NOTE: project deprecated (and the toolchain is now broken); see threejs-figwheel-main for a rewrite in Figwheel Main.
An example project which brings up a minimal "live coding" environment for Clojure-based WebGL in the browser, courtesy of ClojureScript, three.js and Figwheel.
This is basically the Figwheel template project in Leiningen, with the core ClojureScript file set up to do some three.js, and a stripped-down index.html to host the results. The HTML also wheels in three.js from a CDN (so alter to taste).
Most of the effort in this project has gone into making the application state as nearly idempotent as possible, so that repeated page or code reloads don't result in multiple canvas instances, background rendering callbacks, and so on. The reloading is done by completely tearing down the canvas and rendering pipeline and rebuilding; for a proper live coding environment, or for bigger projects, this probably needs to be a bit more subtle.
This project is partially inspired by this by Chris McCormick, Henry Garner's Multisnake, and Chestnut.
To get an interactive development environment run:
lein figwheel
and open your browser at localhost:3449. This will auto compile and send all changes to the browser without the need to reload. After the compilation process is complete, you will get a Browser Connected REPL. An easy way to try it is:
(js/alert "Am I connected?")
and you should see an alert in the browser window.
To clean all compiled files:
lein clean
To create a production build run:
lein cljsbuild once min
And open your browser in resources/public/index.html. You will not
get live reloading, nor a REPL.
Copyright © 2015 Nick Rothwell, nick@cassiel.com.
Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.