Document using CIDER with Fighweel

[expez]

Figwheel is super popular awesomesauce but its usage with CIDER is somewhat unintuitive

How to make this work is documented over at fighweel here but the information is somewhat hard to find.

At least one of our users ran into this: clojure-emacs/cider-nrepl#272

[bbatsov]

Guess we can simply link to this from our README.

[bbatsov]

@expez The documentation was moved. Any idea where to?

[bbatsov]

Seems it's here now https://github.com/bhauman/lein-figwheel/wiki/Using-the-Figwheel-REPL-within-NRepl

[Naomarik]

FWIW I still couldn't get it working with those docs, but that could be just me. If someone had an alternate/simplified version of this it might help others get going in the future.

[expez]

FWIW I still couldn't get it working with those docs, but that could be just me.

Most likely this isn't just you. There are a lot of moving parts involved in getting a clj environment going for emacs these days...

If someone had an alternate/simplified version of this it might help others get going in the future.

Pull-request welcome after you've asked someone in the know on #clojure, on freenode, or clojurians, on slack, and gotten it working ;)

[ghost]

I've gotten figwheel working with the following setup, currently:

profiles.clj:

{:repl
 {:dependencies [[org.clojure/tools.nrepl "0.2.12"]
                 [com.cemerick/piggieback "0.2.1"]
                 [figwheel-sidecar "0.5.0-2"]]     ;; <-- important
  :plugins [[cider/cider-nrepl "0.11.0-SNAPSHOT"]]
  :repl-options {:nrepl-middleware [cemerick.piggieback/wrap-cljs-repl]}}}

project.clj (must be under root, not under a separate profile. The reason for this is that since figwheel is not running from the lein context, it will only read project.clj, not merge anything):

:figwheel { ... custom settings ... }
:cljsbuild { ... :figwheel {:on-jsload "name.space/func"} ... rest of build }

Customize the cider-cljs-repl cider-cljs-lein-repl variable:

'(cider-cljs-lein-repl
  "(do (use 'figwheel-sidecar.repl-api) (start-figwheel!) (cljs-repl))")

edit: Appears that variable was changed yesterday.

If interested, I could create a minimal working example for the documentation. Perhaps figwheel could be added to the default cljs repls, alongside rhino, weasel.

[ghost]

As a side note, this only works with cider-jack-in-clojurescript (so that it runs cider-cljs-repl commands and evaluates your .cljs files to the correct process), and won't work with any variant of cider-connect that I'm aware.

[bbatsov]

@magnars recently documented this.