app
Add a convention-aligned application
When to use it
Create an application with its project configuration, tags, and development tasks. Choose a web app, public site, API, or supported native app type. Web and site apps use the Pages Router by default; select router=app for the App Router. For the native Kotlin preset, follow Create a native Android app.
Usage
npm exec -- nx generate @megamono/plugin:app --dry-runReplace angle-bracket placeholders with reviewed values. Nx's --dry-run previews generator writes; remove it only after reviewing the plan. Examples use npm; use your workspace's package manager if it differs.
Options
Use these options with @megamono/plugin:app. Nx uses the camelCase names shown here; the CLI reference describes command-line aliases. Some options are required only for particular choices.
| Option | Required | Type | Default | Description |
|---|---|---|---|---|
displayName | No | string | — | Extension or Android product display name; defaults to the application basename. |
applicationId | No | string | — | Android-only reverse-DNS application ID and Kotlin namespace. |
contentScriptMatches | No | array | — | Extension-only opt-in page match patterns; omit for a background-only scaffold. |
manifestVersion | No | number | — | Extension-only explicit Chrome/Firefox manifest version. Allowed: 2, 3. |
type | No | string | — | Application preset to create. Allowed: "web", "site", "api", "worker", "mobile", "desktop", "apple", "android", "extension". |
name | No | string | — | Application basename; defaults to the selected type. |
directory | No | string | — | Workspace-relative application root; defaults to apps/<name>. |
scope | No | string | — | Megamono scope tag and package scope. |
port | No | integer | — | Explicit unique development port. |
styling | No | string | — | Styling tool used to render the generated web/site billboard. Auto detects the workspace and falls back to CSS Modules. Allowed: "auto", "chakra", "emotion", "tailwind", "panda", "stylex", "css-modules", "inline". |
router | No | string | — | Next.js router for web/site applications. Defaults to Pages Router; not a router migration command. Allowed: "pages", "app". |
interactive | No | boolean | true | Allow unresolved choices and confirmation to be prompted. |
yes | No | boolean | false | Apply a fully resolved plan without confirmation. |
dryRun | No | boolean | false | Print the ordered plan and write nothing. |
skipInstall | No | boolean | false | Write dependency declarations but skip deferred generator callbacks, including installation. Run the usual workspace install afterwards. |
serviceRunner | No | string | "none" | — Allowed: "none", "springbar". |
Next steps
Review changed files and run the affected project's checks. For options that accept structured values, run the generator's --help or consult the schema in the installed package.
