monoreact

    0.28.1 • Public • Published

    What is it

    This is an advanced workspace implementation for React projects.

    Monoreact includes the following features:

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

    What problems does it solve


    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 because of vendor lock.
    • lerna - completely threw this idea away with existing yarn workspaces and git submodules scripts.
    • tsdx - a great solution but for narrow tasks.

    What can it do now


    Powerful CLI

    Built-in documentation. Type in the console monoreact --help to see information about all possible commands and monoreact [command] --help their description.

    The following options are now available:

    Scaffolding

    • new. Creates a container/host/shell application. This is the initial scaffolding of the entire application.
    • generate a new package (submodule): basic, react. Monoreact 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)). Monoreact allows you to not generate components with all the things that may not necessarily need in each package.

    Execution

    • build and watch 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, Monoreact offers user-friendly control through commands, which increases understanding and speed of interaction with git submodules.

    • checkout
    • fetch
    • init
    • pull

    Workspaces

    Monoreact 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.

    • watch (parallel)
    • build (parallel)
    • test
    • lint

    Migration

    This section is responsible for scripts that will help to adapt the basic state of the package to the desired one.

    • detach. Detach your package from the workspace. Just in case you plan to use the package as a submodule to run it independently outside the host workspace.

    Contributing

    Check out contributing guideline to familiarize yourself with the general rules of the project, as well as to figure out how to bootstrap the project and make changes correctly.


    License

    This project is MIT licensed.

    Install

    npm i monoreact

    DownloadsWeekly Downloads

    97

    Version

    0.28.1

    License

    MIT

    Unpacked Size

    215 kB

    Total Files

    181

    Last publish

    Collaborators

    • retarsis