elm-reactor: Interactive development tool for Elm programs

[ bsd3, compiler, deprecated, language, program ] [ Propose Tags ]

Provides an interactive development tool that makes it easy to develop and debug Elm programs. It will automatically compile any Elm program—independent of editor. It permits hot-swapping and time-traveling debugging.

[Skip to Readme]


Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 0.1, 0.2,, 0.3, 0.3.1
Dependencies base (>=4.2 && <5), blaze-html, blaze-markup, bytestring, cmdargs, containers (>=0.3), directory (>=1.2), elm-compiler (>=0.15 && <0.16), filepath, fsnotify (>=, HTTP, mtl, process, snap-core, snap-server, system-filepath, text, time, transformers, unordered-containers, websockets (>=0.9 && <0.10), websockets-snap (>= [details]
License BSD-3-Clause
Copyright Copyright: (c) 2011-2015 Evan Czaplicki
Author Evan Czaplicki
Maintainer info@elm-lang.org
Category Compiler, Language
Home page http://elm-lang.org
Source repo head: git clone git://github.com/elm-lang/elm-reactor.git
Uploaded by EvanCzaplicki at 2015-04-20T06:46:03Z
Reverse Dependencies 1 direct, 0 indirect [details]
Executables elm-reactor
Downloads 5441 total (7 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2015-05-19 [all 7 reports]

Readme for elm-reactor-0.3.1

[back to package description]

Elm Reactor

Interactive development tool that makes it easy to develop and debug Elm programs. Key features include:

This means you can get a great development experience whether you are using Sublime Text, emacs, vim, or whatever else to edit Elm code.


Install Elm Platform. This will install Elm Reactor and everything else it needs.


Navigate to the Elm project you want to work on. A great project to get started with is elm-examples which contains some simple programs that should be fun to debug.

In the root of your Elm project start the reactor with:


Now open http://localhost:8000 in your browser. You should see a navigation page for your project.

Click on any file to see what it looks like. For example, you can navigate to an Elm file and try it out. If you modify the file, you can just refresh that page and see the new version!

Time Travel Debugging

To use the debugger, click the small wrench next to every Elm file. This will start your Elm program with a control panel that lets you:

  • Pause, rewind, and continue from any point.

  • Add watches and traces to track and visualize values over time.

  • Swap in new code at any time, maintaining all recorded events.

Debugging code embedded in HTML

To use the debugger with more complex HTML or CSS, you may want to start the debugger from within an HTML file. This process is still improving, so use this with caution.

In your custom HTML file, load the /_reactor/debug.js script.

<script type="text/javascript" src="/_reactor/debug.js"></script>

That creates the Elm.fullscreenDebug function so you can initiate your Elm program with the debugger:

var main = Elm.fullscreenDebug('MyProject.Main', 'MyProject/Main.elm');

The first argument is the name of the module you would like to debug. The second argument is the name of the source file for that module. The file name is needed so that we know which file to recompile when the Reactor detects that a file has changed. You may edit a dependency, but we always need to compile from the root file.