Builds a React Component project with useful gulp tasks for development, build and publishing.
See react-component-gulp-tasks for documentation on how to use the gulp tasks.
Install the generator:
npm install -g generator-react-componentThen run the generator:
yo react-component... and follow the prompts.
Your component source code is in src. You can use JSX and ES6 syntax freely in your component source; it will be transpiled to lib with Babel before being published to npm so that your users will simply be able to include it.
It's a great idea to add a description, documentation and other information to your README.md file, to help people who are interested in using your component.
Preview your component with LiveReload:
npm startA webserver will be started on localhost:8000 running the examples in example/src.
You can use this playpen to test your component, and then publish it as live examples to GitHub Pages, which is a great way to let potential users try out your component and see what it can do.
npm run lintYour code will be linted with ESLint, using the Babel parser and the React plugin. You can customise the settings by editing the .eslintrc file.
npm run buildThis will build your lib, dist and example/dist folders ready for release.
You can then publish your component to npm and GitHub Pages by running:
npm run releaseJust run the examples server; no code will be built or watched, everything in example/dist will be served on localhost:8000.
Usually run as part of the release script, this will copy the contents of example/dist to your gh-pages branch and push it.
This task watches the src folder for changes, and builds automatically into lib. This is useful if you are developing your component in another project using npm link.
I'd love to hear it. Open an issue or submit a PR.
MIT License. Copyright (c) 2016 Jed Watson.