For a background on the project, please read our launch blog post.
Flow works with:
- Mac OS X
- Linux (64-bit)
- Windows (64-bit)
There are binary distributions for each of these platforms and you can also build it from source on any of them as well.
Flow is simple to install: all you need is the
flow binary on your PATH and you're good to go.
Installing Flow Per Project
The recommended way to install Flow is via the
npm package. Adding
flow-bin to your project's
- provides a smoother upgrade experience, since the correct version of Flow is automatically used based on the revision you check out
- installs Flow as part of your existing
- lets you use different versions of Flow on different projects
npm install --save-dev flow-bin node_modules/.bin/flow
Installing Flow Globally
Although not recommended, you can also install Flow globally (for example, perhaps you don't use
The best way to install globally is via
npm install -g flow-bin flow # make sure `npm bin -g` is on your path
On Mac OS X, you can install Flow via the Homebrew package manager:
brew update brew install flow
opam install depext opam depext --install flowtype
If you don't have a new enough version of OCaml to compile Flow, you can also use OPAM to bootstrap a modern version. Install OPAM via the binary packages for your operating system and run:
opam init --comp=4.03.0 opam install flowtype eval `opam config env` flow --help
Getting started with flow is super easy.
- Initialize Flow by running the following command in the root of your project
- Add the following to the top of all the files you want to typecheck
/* @flow */
- Run and see the magic happen
More thorough documentation and many examples can be found at http://flowtype.org.
Flow is written in OCaml (OCaml 4.01.0 or higher is required) and (on Linux) requires libelf. You can install OCaml on Mac OS X and Linux by following the instructions at ocaml.org.
For example, on Ubuntu 14.04 and similar systems:
sudo apt-get install ocaml libelf-dev
On OS X, using the brew package manager:
brew install ocaml ocamlbuild libelf opam
Once you have these dependencies, building Flow just requires running
This produces a
bin folder containing the
Running the tests
To run the tests, first compile flow using
make. Then run
bash ./runtests.sh bin/flow
There is a
make test target that compiles and runs tests.
To run a subset of the tests you can pass a second argument to the
bash runtests.sh bin/flow class | grep -v 'SKIP'
Join the Flow community
- Website: http://flowtype.org/
- irc: #flowtype on Freenode
- Twitter: follow @flowtype and #flowtype to keep up with the latest Flow news.
- Stack Overflow: Ask a question with the flowtype tag
Flow is BSD-licensed. We also provide an additional patent grant.