lein-figwheel

lein-figwheel Figwheel builds your ClojureScript code and hot loads it into the browser as you are coding! A new Figwheel!! There is a new Figwheel in town! Figwheel Main is a complete re-write of Figwheel and represents the latest and greatest version of Figwheel. It works great with Leiningen or the new Clojure CLI Tools. So head over to Figwheel Main to give it a try. lein-figwheel Get a quick idea of what figwheel does by watching the 6 minute flappy bird demo of figwheel. Learn even more by watching a 45 minute talk on Figwheel given at ClojureWest 2015. Read the introductory blog post. Support Figwheel If Figwheel has fundamentally redefined the way you do front-end work please take a moment and support it: Donated so far:     2015: $73     2016: $2752     2017(through October): $1979 Current version: Features Live code reloading If you write reloadable code, figwheel can facilitate automated live interactive programming. Every time you save your ClojureScript source file, the changes are sent to the browser so that you can see the effects of modifying your code in real time. Supports Node.js You can use figwheel to live code ClojureScript in Node.js! Static file server The inclusion of a static file server allows you to get a decent ClojureScript development environment up and running quickly. For convenience there is a :ring-handler option so you can load a ring handler into the figwheel server. Live CSS reloading Figwheel will reload your CSS live as well. Live JavaScript reloading Figwheel can live reload your JavaScript source files. Heads up display Figwheel has a non-intrusive heads up display that gives you feedback on how well your project is compiling. By writing a shell script you can click on files in the heads up display and they will open in your editor! Descriptive Errors with Code Context Figwheel provides descriptive compiler errors that point to where the error is in your code. These errors appear in the REPL as well as the heads up display. First Class Configuration Error Reporting It can be quite daunting, when you are configuring a tool for the first time. Figwheel currently offers best-of-class configuration error reporting that will help you if you happen to misconfigure something. Built-in ClojureScript REPL When you launch Figwheel it not only starts a live building/reloading process but it also optionally launches a CLJS REPL into your running application. This REPL shares compilation information with the figwheel builder, so as you change your code the REPL is also aware of the code changes. The REPL also has some special built-in control functions that allow you to control the auto-building process and execute various build tasks without having to stop and rerun lein-figwheel. Robust connection Figwheel's connection is fairly robust. I have experienced figwheel sessions that have lasted for days through multiple OS sleeps. You can also use figwheel like a REPL if you are OK with using print to output the evaluation results to the browser console. Message broadcast Figwheel broadcasts changes to all connected clients. This means you can see code and CSS changes take place in real time on your phone and in your laptop browser simultaneously. Respects dependencies Figwheel will not load a file that has not been required. It will also respond well to new requirements and dependency tree changes. Calculates minimal reload set Figwheel does its best to only reload what needs to be reloaded. This minimizes the surface area of dynamically reloaded code, which in turn should increase the stability of the client environment. Doesn't load code that is generating warnings If your ClojureScript code is generating compiler warnings Figwheel won't load it. This, again, is very helpful in keeping the client environment stable. This behavior is optional and can be turned off. Try Figwheel Make sure you have the latest version of leiningen installed. You can try figwheel out quickly with the flappy bird demo: git clone https://github.com/bhauman/flappy-bird-demo.git then cd into flappy-bird-demo and type lein figwheel You can now goto localhost:3449/index.html and open up src/flappy_bird_demo/core.cljs with your favorite editor and start coding. Make sure you open your browser's development console so you can get feedback about code reloads. If you would prefer to greenfield a new project you can use the figwheel leiningen template. lein new figwheel hello-world Or optionally: lein new figwheel hello-world -- --om ;; for an om based project lein new figwheel hello-world -- --reagent ;; for a reagent based project Learning ClojureScript If you are brand new to ClojureScript it is highly recommended that you do the ClojureScript Quick Start first. If you skip this you will probably suffer. There is a lot to learn when you are first learning ClojureScript, I recommend that you bite off very small pieces at first. Smaller bites than you would take when learning other languages like JavaScript and Ruby. Please don't invest too much time trying to set up a sweet development environment, there is a diverse set of tools that is constantly in flux and it's very difficult to suss out which ones will actually help you. If you spend a lot of time evaluating all these options it can become very frustrating. If you wait a while, and use simple tools you will have much more fun actually using the language itself. Quick Start If you are new to Figwheel here is a Quick Start tutorial. Working through this Quick Start will probably save you a tremendous amount of time. Getting Help You can get help at both the ClojureScript Google Group and on the #clojurescript, #lein-figwheel and #beginners Clojurians Slack Channels Usage Make sure you have the latest version of leiningen installed. Then include the following :dependencies in your project.clj file. [org.clojure/clojure "1.9.0"] [org.clojure/clojurescript "1.10.238"] Then include lein-figwheel in the :plugins s