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
If you’d like to inject more deps you’ll have to modify the
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")
Always use the fully qualified
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)
If you’re registering a self-hosted (native) ClojureScript REPL (e.g.
You can also modify the known ClojureScript REPLs on a per-project basis using
;; 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.
By default CIDER will enrich the ClojureScript completion results using
the suitable library. If case you run
suitable-related issues you can disable the enhanced completion like this:
(setq cider-enhanced-cljs-completion-p nil)