How to use Calva and Reveal together

Reveal is a "Read Eval Visualize Loop for Clojure". This page describes how to use Reveal in your development setup based on Calva.

When using tools.deps

You can go for the nrepl middleware or just add the dependency.

Use Reveal nrepl middleware

This will make Reveal to start together with your project.

Note

This will make all Calva evaluations go to Reveal. Too chatty for you? Take the dependencies only approach.

Add this alias deps.edn:

:aliases
{:reveal-nrepl-middleware
    {:extra-deps {vlaaad/reveal {:mvn/version "1.3.194"}}
     :main-opts  ["-m" "nrepl.cmdline"
                  "--middleware" "[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]"]}}

And then jack-in choosing the deps.edn option and then pick the :reveal-nrepl-middleware alias.

Dependencies only

If you don't want to use the nrepl-middleware you can configure just the dependency and then start Reveal yourself.

The alias:

:reveal-dep-only
  {:extra-deps {vlaaad/reveal {:mvn/version "1.3.194"}}}

A custom REPL command for starting Reveal in your project:

    "calva.customREPLCommandSnippets": [
        ...
        {
            "name": "Start Reveal Tapper",
            "snippet": "(require '[vlaaad.reveal :as reveal])(add-tap (reveal/ui))",
            "key": "sr"
        },
        ...
    ]

See Custom REPL Command for how to configure more commands, and bind shortcuts to them, to make Reveal integration nice for you.

When using Leiningen

In your project.clj, add a profile named "reveal":

:profiles {:reveal {:dependencies [[vlaaad/reveal "1.3.194"]]
                    :repl-options {:nrepl-middleware [vlaaad.reveal.nrepl/middleware]}}}

Now when you jack-in using Calva, you enable this profile and Reveal will be started automatically. Please note that Reveal requires Java 8 or higher, and uses JavaFX. Depending on your setup, you may need to make sure it is available.

Tips about font size

If you find the font to small you can add a :jvm-opts key to make it a little bigger:

:aliases
{:reveal
    {:extra-deps {vlaaad/reveal {:mvn/version "1.3.194"}}
     :jvm-opts   ["-Dvlaaad.reveal.prefs={:font-size,17}"]
     :main-opts  ["-m" "nrepl.cmdline"
                  "--middleware" "[vlaaad.reveal.nrepl/middleware,cider.nrepl/cider-middleware]"]}}