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.
## Features
- Replaces React Native packager to bundle your app
- Access to full webpack ecosystem, using additonal loaders and plugins is simple
- Doesn't need watchman, symlinks work nicely
- Helpful and easy to understand error messages
## 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):
```bash
yarn add --dev haul-cli
```
If you're on a React Native version >= 0.43, add the following in `android/app/build.gradle` somewhere before the `apply from: "../../node_modules/react-native/react.gradle"` statement:
```
project.ext.react = [
cliPath: "node_modules/haul-cli/bin/cli.js"
]
```
To configure your project to use haul, run the following:
```bash
yarn run haul init
```
This will automatically add the configuration needed to make Haul work with your app, e.g. add `webpack.haul.js` to your project, which you can customise to add more functionality.
Next, you're ready to start the development server:
```bash
yarn run haul start -- --platform ios
```
Finally, reload your app to update the bundle or run your app just like you normally would:
```bash
react-native run-ios
```
