haul: A TypeScript repository from wilbert-abreu

A command line tool for developing React Native apps

Haul is a drop-in replacement for react-native CLI built on open tools like Webpack. It can act as a development server or bundle your React Native app for production.

@haul-bundler/cli and other packages under @haul-bundler scope are a overhaul of haul package and support only React Native 0.59.0 and above. If you need to support older versions, please check legacy branch.

@haul-bundler/cli and other packages requires Node 10 to be installed. If you're running older version, please upgrade to Node 10 LTS or newer.

Features

Replaces React Native packager to bundle your app
Access to full webpack ecosystem, using additional loaders and plugins is simple
Doesn't need watchman, symlinks work nicely
Helpful and easy to understand error messages

Packages

Name	Description	Required
`@haul-bundler/cli`	CLI and commands implementation.	Yes
`@haul-bundler/core`	Core logic and functionality.	Yes (installed with `cli`)
`@haul-bundler/core-legacy`	Legacy logic from `haul` package	Yes (installed with `cli`)
`@haul-bundler/babel-preset-react-native`	Babel preset tweaked for RN 0.59+, which can decrease the bundle size by using only the necessary transforms.	Yes (installed by `init` command)
`@haul-bundler/basic-bundle-webpack-plugin`	Webpack plugin with tweaks for plain JS bundle.	Yes (installed with `cli`)
`@haul-bundler/ram-bundle-webpack-plugin`	Webpack plugin for RAM bundle support.	Yes (installed with `cli`)
`@haul-bundler/preset-0.59`	Preset with configuration tweaked for RN 0.59.	Yes (installed by `init` command when using RN 0.59)
`@haul-bundler/preset-0.60`	Preset with configuration tweaked for RN 0.60.	Yes (installed by `init` command when using RN 0.60)
`@haul-bundler/inspector`	Haul inspector with `haul-inspector` binary.	No (optional).
`@haul-bundler/inspector-events`	Shared logic between `cli` and Haul `inspector`.	Yes (installed with `cli`)

Getting started

Start by adding Haul as a dependency to your React Native project (use react-native init MyProject to create one if you don't have a project):

yarn add --dev @haul-bundler/cli

# Traditionalist? No problem:
npm install --save-dev @haul-bundler/cli

To configure your project to use haul, run the following:

yarn haul init
# npm >= 5.2.0 :
npx haul init
# npm < 5.2.0 :
npm install -g npx
npx haul init

This will automatically add the configuration needed to make Haul work with your app, e.g. add haul.config.js to your project, which you can customize to add more functionality.

Next, you're ready to start the development server:

yarn haul start
# Or:
npx haul start

Finally, reload your app to update the bundle or run your app just like you normally would:

react-native run-ios

Documentation

Check out the docs to learn more about available commands and tips on customizing the webpack configuration.

Limitations

Haul uses a completely different architecture from React Native packager, which means there are some things which don't work quite the same.

Delta Bundles (RN 0.52+) have minimal support
Existing react-native commands
No support for Hot Module Replacement

The following features are unlikely to be supported in the future:

Haste module system: use something like babel-plugin-module-resolver instead
Transpile files under node_modules: transpile your modules before publishing, or configure webpack not to ignore them

Made with ❤️ at Callstack