@re-space/cli NPM

The project is under active development. The documentation updated iteratively.

What problems does it solve

What is it

This is an advanced workspace implementation for react applications.

Re-space includes the following features:

develop regular react apps
scaffold React projects
build JavaScript, TypeScript, React libraries
implement monorepo, workspaces, submodules
workspace, submodules management
efficient bundling (rollup)
workspace dependency awareness (connectivity)

Why is this an advanced implementation

It uses CLI, which does what you exactly need to build react applications.

Motivation

The primary motivation was not to be tied to existing solutions of vendors, so as not to get into vendor lock.

Nevertheless, I recommend considering alternative solutions:

nx/react - a super powerful tool that can do everything, but turned out to be redundant for me.
lerna - completely threw this idea away with existing yarn workspaces, yarn, and git submodules scripts.
tsdx - an interesting idea, where I had to learn a lot; however, it also does and does not do what my project precisely needed.

What can it do now

Even in its raw form, it is already ready for use, and here is what exactly you can do with re-space:

scaffold project and build React applications with create-react-app
bundle your packages with rollup
use advanced CLI re-space/cli
save your time with typescript (with the option not to use it)
symlinking yarn workspaces
enjoy configured testing(jest), formatting(prettier), linting (eslint + stylelint), git hooks(husky + lint-staged))

Powerful CLI

This CLI has the built-in documentation. Type in the console re-space --help to see all possible scripts and their description.

The following options are now available:

Scaffolding

new. Creates a host/shell application. This is the initial scaffolding of the entire application.
generate a new package (submodule): basic, react. Re-space creates a distribution of responsibility. Not all packages must deal with react components. Sometimes you want to build plain JavaScript/TypeScript libraries.
add a new feature (available options: docz, playground(run packages locally inside the package workspace)). Re-space allows you to not generate components with all the things that may not necessarily need in each package.

Execution

build and serve your package with a modern rollup module bundler. Rollup is the best choice for building independent libraries due to efficient tree-shaking and fast compilation.
test and lint your package with Jest and eslint. These built-in packages are crucial for increasing and maintaining the quality of built libraries.
install dependencies. This option provides workspace dependency management. If you are running install inside some package, it'll add these dependencies as "peer" and add them to the root.

Submodules

It is quite challenging for managing git submodules. You have to perform many actions to make a simple task happen, and this is what scares people off from using submodules. In turn, Re-space offers user-friendly control through commands, which increases understanding and speed of interaction with git submodules.

checkout
fetch
init
pull

Workspaces

Re-space offers a much efficient alternative to the "yarn workspaces". It analyzes your dependencies between workspaces and runs them in the desired sequence and in parallel, when necessary and appropriate.