# megamono add

Syntax, options, and usage for the add command.


Add an application, database, or repository module to an existing Megamono workspace. Run this command from the workspace root.

## Add an application

```sh
megamono add app web --dry-run
```

Review the proposed files, then run the command without `--dry-run` to proceed. See [application options](/docs/generators/app), [libraries](/docs/generators/library), and [database setup](/docs/cli/database) for more choices.

## Command options

Use the help below for exact syntax and options. You can also run `megamono add --help` in your terminal.

```text
Usage: megamono add app [type] [options]
       megamono add library <name> [--platform=neutral|web|node|mobile|worker] [--publishable] [--access=restricted|public] [--skipInstall] [--dry-run|--yes]
       megamono add database [name] [options]
       megamono add integration --packages=<names> [options]
       megamono add springbar [--springbar-candidates=<names>] [--dry-run|--yes]
       megamono add <module> [options]

Examples:
  megamono add app web
  megamono add app api --name=admin-api --interactive=false --yes
  megamono add app web --dry-run
  megamono add app android --applicationId=com.example.app --yes
  megamono add library browser-auth --platform=web --yes
  megamono add library client --publishable --access=public --skipInstall --yes
  megamono add database events --adapter=drizzle
  megamono add database primary --adapter=prisma --interactive=false --yes
  megamono add integration --packages=@playstack/rate-limit --api=apps/api --dry-run
  megamono add docs
  megamono add ci --dry-run
  megamono add springbar --dry-run

Application types: web, site, api, worker, mobile, desktop, apple, android, extension
Web styling: chakra, emotion, tailwind, panda, stylex, css-modules, inline
Next.js router: --router=pages|app (web/site only; default pages)
Android options: --displayName=<product-name> --applicationId=<reverse-DNS-id>
  Defaults to apps/android; --name selects apps/<name>. JDK 17 and Android SDK 36 required to build.
Extension options: --displayName=<product-name> --manifestVersion=2|3
  --contentScriptMatches=<patterns> explicitly opts into page access.
  Omit for a background-only extension with no permissions.
Database adapters: prisma, drizzle
Modules: docs, agents, ci, release, lint, skills, health, inference

Integration options:
  --web|--api|--worker|--portable=<root>
                       Map package-authored surfaces to reviewed Nx roots
  --adapters=<names>   Resolve adapter:<name> conditions
  --persistence=package|application
                       Select database artifact ownership
  --adoption-mode=fresh|compare|shadow|cutover
                       Record the migration phase
  --conditions='<json>'
                       Resolve package-authored contextual conditions
  --decisions='<json>' Resolve required package-authored decisions
  --equivalences='<json>'
                       Map requirements and templates to reviewed existing wiring
  --verification='<json>' --verification-project=<Nx name>
                       Map required test IDs to existing Nx targets
  --ci-workflow=<path> --ci-job=<name>
                       Append verification to an explicitly selected existing job
  --migration-stages='<json>'
                       Record verified compare/shadow/cutover/rollback transitions
  --composition='<json>'
                       Generate a shared Nest library module and optional AppModule connection
  --dry-run            Report templates, overlap, and unresolved choices
  --yes                Materialize verified templates after review

Add commands require an initialized workspace with local nx and @megamono/plugin.
```

[All CLI commands](/docs/cli)