Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including fable-compiler with all npm packages installed. Try it out:

var fableCompiler = require("fable-compiler")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

fable-compiler v0.7.51

F# to JavaScript compiler

F# |> BABEL

The compiler that emits JavaScript you can be proud of!

Mono Build Status .NET Build Status npm Join the chat at https://gitter.im/fable-compiler/Fable

RELEASE NOTES · Follow us on Twitter!

Fable brings together the power of the F# compiler and Babel to make JavaScript a true backend for F#. Some of its main features are:

  • Works directly on F# source code, no compilation to .NET bytecode needed
  • Optimizes F# code to generate as clean JavaScript as possible
  • Passes location data to Babel to generate source maps
  • Compatible with all Babel plugins and other JS development tools, like Webpack
  • Support for most of the F# core library and a bit of .NET Base Class Library
  • Tiny core library included (around 20KB minified and gzipped) with no runtime
  • Organizes code using ES6 modules
  • Interacts seamlessly with other JavaScript libraries
  • Bonus: compile NUnit tests to Mocha

Usage

Fable is distributed through npm! You can install and run it just by typing:

npm install -g fable-compiler
fable path/to/your/project.fsproj

Note the package name is fable-compiler while the command is just fable

You can find more detailed instructions about F# to JS compilation in the docs. Also you can have a look at the samples or download them from here.

Requirements

You must have F# 4 and node 4.4 or higher installed in your computer.

If you are having problems to use Fable under Windows, try the following:

  • Make sure fsc.exe is added to the path.
  • Install MSBuild tools 2013.

Contributing

Just by using Fable you're already contributing! You can help a lot the community by sharing examples and experiences in your personal blog or by sending a PR to Fable's website (see this for more info).

Send bug reports (ideally with minimal code to reproduce the problem) and feature requests to the GitHub repository. Issues with the label discussion will be also added to ask the opinion of the community on different topics like the logo, roadmap, etc. For more immediate comments you can use the Gitter chat.

A plugin system is also available to allow you extend Fable according to you needs.

Caveats

  • Options are erased in compiled code. This has several benefits like removing overhead and interacting with native JS functions in a safer way (null will be None). However, it will lead to unexpected results if you do weird things like wrapping null in Some. For practical purposes, Fable considers null, undefined, None and unit to be the same thing.

  • Information about generic types is not included in the generated JavaScript, so code that depends on this information to be known at runtime for method dispatching may have unexpected behaviour.

To know more, read Compatibility.

Acknowledgements

Of course, this project wouldn't have been possible without the fantastic work of the F# compiler and Babel teams. I hope they feel proud seeing how their work has met in a very unexpected way, giving developers even more possibilities to build great apps.

The awesome F# community has played a big role in making this possible. I've met incredible people and it's impossible to list all the names without forgetting anyone, but I'd like to give a particular mention to Zach Bray for his work on FunScript, Don Syme (the fact that the designer of the language himself shows interest in your work, no matter how humble it is, is really a big push!) and Krzysztof Cieślak (I always have to look up the name to spell it correctly) because he's shown that F# is a perfect fit for a big project targeting JS.

And finally I'd like to thank my partner (is it too old-fashioned to say wife?) for bearing with me everyday.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free