/boot-cljs-example

Example application using boot, boot-cljs, boot-cljs-repl, and boot-reload.

Primary LanguageClojure

boot-cljs-example Build Status

Example project using the boot build tool with the boot-cljs, boot-cljs-repl, and boot-reload tasks.

Prepare

Install boot. Then, in a terminal:

boot -u

This will update boot to the latest stable release version. Since boot is pre-release software at the moment, you should do this frequently.

Build

In a terminal do:

boot serve -d target/ watch speak reload cljs-repl cljs -sO none

This builds a pipeline for your project:

  • serve Starts a local web server. This task comes from the pandeiro/boot-http library.

    • -d Use target/ as the document root

  • watch Starts incremental build loop. Project will be rebuilt when source files change.

  • speak Audible notification (plays a sound file) for each build iteration, notifying of errors or warnings when appropriate.

  • reload Starts live-reload websocket server and connects browser client to it. Resources (stylesheets, images, HTML, JavaScript) in the page are reloaded when they change.

  • cljs Compiles ClojureScript namespaces to JavaScript.

    • -s Create source maps for compiled JavaScript files.
    • -O none Use optimizations none (no GClosure compiler pass).

You can view the generated content by opening http://localhost:3000/index.html in your browser.

OutOfMemoryError Troubleshooting

boot provides a tool called pods that make it possible for multiple independent Clojure classpaths to exist in the same JVM. Task authors can use Maven dependencies without worrying about shadowing or otherwise interfering with the dependencies in other pods.

One downside of pods is that their use results in higher-than-usual memory consumption by the JVM, particularly PermGen.

If you are using Java 7, you may see errors related to PermGen. You can consult the JVM Options wiki page for settings that can help.

You may also consider upgrading to Java 8, as it resolves many PermGen-related issues.

Start Browser REPL

With the build pipeline humming in the background, you can connect to the running nREPL server with either your IDE or at the command line in a new terminal:

boot repl --client

Then, you can start a CLJS REPL:

boot.user=> (start-repl)

Reload the page in your browser. Your REPL is now connected to the page.

License

Copyright © 2014 Adzerk

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.