flow-typed

A repository of high-quality, third-party library type definitions for use with Flow.

Check out the quick start page in the docs to get started. It will walk you through installing typedefs, using them, as well as writing and including your own.

Huh?

When you start a project with Flow, you likely want to use some third-party libraries that were not written with Flow. By default, Flow will just ignore these libraries leaving them untyped. As a result, Flow can't give errors if you accidentally mis-use the library (nor will it be able to auto-complete the library).

To address this, Flow supports library definitions which allow you to describe the interface of a module or library separate from the implementation of that module/library.

The flow-typed repo is a collection of high-quality library definitions, tests to ensure that definitions remain high quality, and tooling to make it as easy as possible to import them into your project.

All you have to do when you add one or more new dependencies to your project is run flow-typed install. This will search the libdef repo and download all the libdefs that are relevant for your project and install them for you. After that, simply check them in and be on your way!

The CLI

The flow-typed npm package provides a CLI that includes several commands for working with this repository. The full list of commands is available in the docs .

FAQs

Before opening an issue, take a look at the FAQs. Chances are your question has already been answered! If not, don't hesitate to open an issue.

How Do I Contribute Library Definitions?

Just send a pull request! The documentation highlighted in CONTRIBUTING.md should give a detailed overview of how to raise a pull request following our best practices.

Contributing to the CLI

Bugfixes and improvements to the core CLI are welcome. If you'd like to contribute a new feature, consider opening an issue first to discuss it.

Active Maintenance Team

@AndrewSouthpaw	@Brianzchen	@GAntoine	@pascalduez	@villesau

Changelog

[3.8.0] 2022-06-26

Added

• Core definitions (#4255)
• Create test harness (#4268)
• Make use of flow-typed.config.js for ignored (#4288)

Changed

• Consistent list logging (#4287)
• Coerce cli version with semver to allow for prerelease tags (#4291)
• Fix if dependency is resolved npm package (#4298)
• Bump minimist from 1.2.0 to 1.2.6 in (#4293)
• [docs] contract -> contrast (#4281)
• [docs] update command doesn't take positional arguments (#4328)
• [docs] document create-stub --typescript flag (#4329)