Configuration
In this section we’ll briefly examine some common configuration
options related to ClojureScript. Configuration that is specific
to a particular REPL (e.g. shadow-cljs
) is covered separately
in the individual REPL setup sections.
Modifying the ClojureScript jack-in dependencies
Out-of-the-box, CIDER injects a single dependency into ClojureScript REPLs - namely piggieback
.
If you’d like to inject more deps you’ll have to modify the cider-jack-in-cljs-dependencies
variable. Here’s an example:
;; let's add Weasel on jack-in
(cider-add-to-alist 'cider-jack-in-cljs-dependencies "weasel/weasel" "0.7.1")
Typically, modifying this variable is not needed, as ClojureScript dependencies are declared explicitly in your project configuration most of the time.
Modifying this variable will affect all ClojureScript REPL types. |
Setting a Default ClojureScript REPL Type
If you frequently use the same ClojureScript REPL, you can set
cider-default-cljs-repl
and CIDER will skip the prompt and use this
instead. For example, the following will make Node.js the default:
(setq cider-default-cljs-repl 'node)
Defining Custom ClojureScript REPL Types
All supported ClojureScript REPLs are stored in
cider-cljs-repl-types
. If you need to extend it, you should use
cider-register-cljs-repl-type
in your Emacs configuration.
(cider-register-cljs-repl-type 'super-cljs "(do (...))" optional-requirements-function)
You can also modify the known ClojureScript REPLs on a per-project basis using
.dir-locals.el
:
;; replace the list of REPL types and set some default
((nil
(cider-default-cljs-repl . super-cljs)
(cider-cljs-repl-types . ((super-cljs "(do (foo) (bar))")))))
;; modify the list of known REPLs and set some default
((nil
(eval . (cider-register-cljs-repl-type 'super-cljs "(do (foo) (bar))"))
(cider-default-cljs-repl . super-cljs)))
For one-off REPLs you can also use the custom REPL init form like this:
;; modify the list of known REPLs and set some default
((nil
(cider-custom-cljs-repl-init-form . "(do (foo) (bar))"
(cider-default-cljs-repl . custom)))
If you already have a Clojure REPL running and want to add a
ClojureScript REPL, you can invoke
cider-jack-in-sibling-clojurescript
to add it.
Enhanced Completion
By default CIDER will enrich the ClojureScript completion results using
the suitable library. If case you run
into any suitable
-related issues you can disable the enhanced completion like this:
(setq cider-enhanced-cljs-completion-p nil)