Migrating from Flow to Typescript: Why? How? Worth it?

Samuel Briole
Apr 12, 2019 · 4 min read
Image for post
Image for post
Photo by Gary Bendig on Unsplash

When I arrived at Inato, the codebase was written in ES6. Then, we added some robustness with Flow. It helped us perform major refactors and lower our bug count. We were happy… until problems showed up.

Problems we had with Flow

  • Flow takes a lot of RAM and computing resources (we witnessed > 10 Go of RAM).
  • The integration with text editors is not state-of-the-art. We could not find a way to make auto-completion and auto-imports work in VSCode.
  • There is no official support for exporting type definitions from a module (this is painful when we split our code into different modules)
  • For some npm packages, either typings are missing in , or typings are incomplete / out of date. For instance and have poor flow definitions. This makes the code less safe.

Project-specific problems we had with Flow

  • React typings are bound to Flow’s version. After we upgraded React to 16.8.4 in order to use hooks, we wrote some unsatisfying
Image for post
Image for post
  • In the library, the typing of is wrong, and breaks the type safety for numerous components. (see the GitHub issue)

Exploring alternatives to Flow

What are the other typed languages that compile to Javascript? Typescript and ReasonML seem to be the best candidates.

  • ReasonML produces very safely typed code. The syntax is quite different from ES6 though, and the ecosystem looks young.
  • Typescript is a great typed language with a large community. The ecosystem is mature and the syntax is similar to ES6. This is obviously the best choice for us.

How to migrate to Typescript

  • If you use Flow, you probably use Babel. Upgrade to babel 7 to use the Typescript preset.
  • Install typescript ()
  • Add a file at the project root. Use in the compiler options.
  • Change the file extensions from to (or if your project uses JSX). You can run this command to rename all files at once in the extension:
find src -name "*.js" -exec sh -c 'mv "$0" "${0%.js}.ts"' {} \;
  • Monitor the errors: . You will see a lot of syntax errors. You can fix most of them with a couple of regexes:
Search and replace:{|{
import typeimport
Regexes:\+(\w+) ⇒ readonly $1
: \?(\w+<?\w*>?) ⇒ : $1 | null | undefined
<\?(\w+)> ⇒ <$1 | null | undefined>
\$PropertyType<(\w+), ('?\w+'?)> ⇒ $1[$2]
  • After your syntax errors count has gone to 0, you will see a lot of new errors. These are type errors ! There is no generic way to fix them, handle them one by one (this is the longer part of the process).
  • Update your babel config. It should look like this:
"presets": ["@babel/env", "@babel/typescript"],
"plugins": [
  • Update your linter. If you’re using ESLint, use @typescript-eslint
  • Update your test suite. If you’re using Jest, use

Is it worth it?

YES! Definitely!
We’ve eliminated almost all problems we had with Flow. We’re still having small issues with composite projects, but overall it’s a great improvement.

  • The Typescript integration in VSCode is impressive: auto-imports and auto-complete work.
  • We have no more inconvenient RAM usage.
  • contains a lot of typings and the quality of these typings is great overall. No more problems with and typings.
  • It’s easy to export type definitions => it encourages developers to split their code into smaller packages (which I think is a good practice)

It’s too soon to witness the impact on our productivity, so I measured the impact on the “Developper Happiness” among team members. I’m assuming that happy coding is correlated with less problems and higher productivity. Here are the results:

Image for post
Image for post
Image for post
Image for post


Flow is a great tool a lot of people are happy with. But it has some limitations when the codebase becomes big. If you’re experiencing the same problems as we did, I strongly recommend to migrate.


Thoughts & experiences from the Inato team

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store