Minimalistic boilerplate to jump-start a Node.js project in ES6 with Flow type checking.
Provides a basic template, batteries included:
- ES6 + babel,
- Removes Flow type annotations,
- Transforms imports to lazy CommonJS requires,
- Transforms async/await to generators,
- ESLint with the airbnb-base and flowtype rules,
- Jest unit testing and coverage,
- Type definitions for Jest,
- NPM scripts for common operations,
- .editorconfig for consistent file format,
- Yarn lockfile so only verified and up-to-date dependencies are installed.
This project requires Node.js 6.9 (LTS) or later (but should work with any 6.2 or newer release) and NPM, Yarn is optional but recommended. Make sure you have those installed. Then just type following commands:
git clone https://github.com/jsynowiec/node-flowtype-boilerplate
cd node-flowtype-boilerplate
yarn
or if you don't have yarn installed
npm install
Run using either npm run <script>
or yarn run <script>
comand.
clean
- remove coverage data, Jest cache and transpiled files,lint
- lint source files and tests,typecheck
- check type annotations,test
- lint, typecheck and run tests with coverage,test-only
- run tests with coverage,test:watch
- interactive watch mode to automatically re-run tests,build
- compile source files,build:watch
- interactive watch mode, compile sources on change.
If you have any questions regarding this project:
- consult the FAQ wiki page first,
- search for issues marked as question,
- if none of the above is appropriate, open an issue.
As an alternative to Flow type checking, you can try my Node.js TypeScript boilerplate. It's basically the same but with TypeScript and TSLint.
MIT License. See the LICENSE file.