@usemosaik/cli

The CLI runtime behind Mosaik, a modular scaffolding tool for React, Express, and NestJS. It discovers the shipped generators, templates, and plugins, and implements the create, add, and doctor commands. This package is used by the create-mosaik command-line entry point.

Create a project

Use the executable package to get started:

npx create-mosaik@latest create my-app
cd my-app
npm run dev

Choose npm in the prompts for this example. Mosaik also supports pnpm, Yarn, and Bun. Node.js 22 or later is required.

Manage an existing Mosaik project

From the generated project root:

npx create-mosaik@latest add
npx create-mosaik@latest doctor

add installs a compatible shipped plugin. doctor reports project metadata, compatibility, Node.js, and package-manager diagnostics without changing files. Both use .mosaik/project.json. These commands are available in 1.1.0 and later.

For all five generators, descriptions of all 35 plugins, command examples, and troubleshooting, read the full Mosaik guide.

Package role

@usemosaik/cli composes Mosaik's runtime adapters and discovers its declared generator, plugin, and template dependencies. Installing it alone does not provide a command-line executable; use create-mosaik for the supported end-user workflow. Contributors can read the architecture documentation.

Links

• Source
• Issues
• MIT license