Awesome
rackt-cli
Command line interface for automating common tasks when building React.js components.
Installing
$ npm install -g rackt-cli
About
The motivation for this CLI is to make it simple to get started when creating a new component, and eliminate the boilerplate that is commonly copy/pasted from one project to another. This CLI provides all config, dev dependencies, and scripts for building, testing, and releasing. There is even a command for generating a new component structure. By leveraging rackt-cli
, you are able to focus on writing code.
Usage
Command | Purpose |
---|---|
rackt | Prints out a list of available commands. |
rackt init <name> | Creates a folder called <name> and generates a component structure. |
rackt build | Builds the component to dist/ for UMD, and build/ for CommonJS. |
rackt server | Starts the dev server using port 8080 . |
rackt release | Publish a new release to npm. Use --preview to preview release. |
rackt test | Runs the test suite. Use --single-run for single run. |
rackt pages | Deploys the examples to gh-pages. |
init
The init
command generates a component structure based on the opinions of this CLI.
It provides a basic working component, along with a simple example, and a failing test.
build
The build
command uses webpack, along with babel to transpile your code.
This means you are free to use JSX, and ES6 in your source, as it will be transpiled before shipping.
This command will generate two new folders within your component's folder.
A dist/
folder contains a UMD version of your project, which is ideal for releasing to bower.
A build/
folder will contain a transpiled version of your original source, un-bundled, for releasing to npm.
server
The server
command uses webpack-dev-server to serve your examples in the browser.
You may also run npm start
as an alias to this command.
release
The release
command runs test
, and build
command, then updates your CHANGELOG, creates a new tag, and releases to npm.
test
The test
command runs karma, using mocha.
It will look for files under lib/
suffixed with -test.js
.
You can put these files alongside your source, or under sub-folders like __tests__/
.
pages
The pages
command will deploy your examples to a gh-pages
branch.
License
MIT