CLI for creating reusable, modern React ts libraries using Rollup and Parcel.
This package was inspired by create-react-library
Simplify the progress of creating a react-ts library .
Take advantage of Parcel and Rollup .
- Easy-to-use CLI
- Handles all modern JS features
- parcel for example usage and local dev
- Rollup for bundling
- Babel for transpiling
- Jest + testing-library for react testing
- Supports complicated peer-dependencies
- Supports CSS modules
- TypeScript Only
- Sourcemap creation
- lint-staged support
- Conventional commit by
- standard-version support by
npm run release
- github Actions
- Format on Save ( Vscode Editor )
- Travis CI & Code coverage by custom configration
- parcel-proxy-server for Proxy serve support
- storybook support
This package requires
node >= 10.
npm install -g @21epub/create-parcel-react-library
Usage with npx
No need to create an empty folder before running.
Creating a New Module
Answer some basic prompts about your module, and then the CLI will perform the following steps:
- copy over the template
- install dependencies via yarn or npm
- install peers vis yarn or npm (You have to do this since peers will not auto installed , dev start will cause error !)
- initialize local git repo
At this point, your new module is ready and is all setup for local development.
There's only one thing to do your development is enjoy your coding in
src/ and your example in
npm start # start your example dev code
Now, anytime you make a change to your library in
example/ will live-reload your parcel dev so you can iterate on your component in real-time.
Update Peer Dependencies
peerDependencies in package.json .
npm run install-peers # reinstall peers after update
Init storybook environment by
npx sb init
Get Start with Storybook and develop your Component, Reference docs
npm run storybook
Commit Method Recommandation
npm run commit # lint before commit can save your time , and then conventional commit with git-cz
Set API proxy config in
npm run start:proxy # start proxy server
Open proxy server url:
Publishing to npm
npm run release # Version and changelog git push --follow-tags origin master npm publish # The `prePublishOnly` hook will run before publish to build and test your package
es versions of your module to
dist/ and then publishes your module to
Make sure that any npm modules you want as peer dependencies are properly marked as
package.json. The rollup config will automatically recognize them as peers and not try to bundle them in your module.
MIT © 21epub