> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentfront.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Nx Plugin Overview

> @frontmcp/nx — Nx generators and executors for FrontMCP monorepos

`@frontmcp/nx` is the official Nx plugin for FrontMCP. It provides **20 generators** for scaffolding projects and components, and **7 executors** for building, testing, and deploying your servers — all integrated with the Nx build system.

<Info>
  Use the Nx plugin when you want monorepo-scale development: shared libraries, multi-app composition, per-environment servers, and Nx's dependency graph + affected commands.
</Info>

## When to Use the Nx Plugin

| Scenario | Recommendation |
| - | - |
| Single MCP server | Use `npx frontmcp create` (standalone) |
| Multiple apps sharing code | Use `@frontmcp/nx` (monorepo) |
| Team with shared libraries | Use `@frontmcp/nx` (monorepo) |
| Multiple deployment targets | Use `@frontmcp/nx` (monorepo) |
| Existing Nx workspace | Add `@frontmcp/nx` |

## Architecture

The Nx plugin organizes your code into three layers:

```mermaid theme={"theme":{"light":"snazzy-light","dark":"dark-plus"}}
graph TD
    S1["servers/production"] --> A1["apps/crm"]
    S1 --> A2["apps/analytics"]
    S2["servers/staging"] --> A1
    S2 --> A3["apps/admin"]

    A1 --> L1["libs/shared-utils"]
    A2 --> L1
    A1 --> L2["libs/crm-plugin"]
    A3 --> L1

    style S1 fill:#16A34A,color:#fff
    style S2 fill:#16A34A,color:#fff
    style A1 fill:#2563EB,color:#fff
    style A2 fill:#2563EB,color:#fff
    style A3 fill:#2563EB,color:#fff
    style L1 fill:#7C3AED,color:#fff
    style L2 fill:#7C3AED,color:#fff
```

| Layer | Directory | Purpose |
| - | - | - |
| **Apps** | `apps/` | FrontMCP applications with tools, resources, prompts |
| **Libs** | `libs/` | Shared libraries (generic, plugin, adapter, tool-register) |
| **Servers** | `servers/` | Deployment shells that compose apps for a target platform |

## Feature Summary

### Generators (20)

| Category | Generators |
| - | - |
| **Structural** | `workspace`, `app`, `lib`, `server` |
| **Component** | `tool`, `resource`, `prompt`, `skill`, `skill-dir`, `agent`, `provider`, `plugin`, `adapter`, `auth-provider`, `flow`, `job`, `workflow` |
| **UI** | `ui-component`, `ui-page`, `ui-shell` |

### Executors (7)

| Executor | Wraps | Cacheable |
| - | - | - |
| `build` | `frontmcp build` | Yes |
| `build-exec` | `frontmcp build --target node` | Yes |
| `dev` | `frontmcp dev` | No (long-running) |
| `serve` | `frontmcp start` | No (long-running) |
| `test` | `frontmcp test` | Yes |
| `inspector` | `frontmcp inspector` | No (long-running) |
| `deploy` | Platform-specific | No |

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="arrow-down-to-line" href="/frontmcp/getting-started/installation">
    Install @frontmcp/nx in new or existing workspaces
  </Card>

  <Card title="Quickstart" icon="rocket-launch" href="/frontmcp/getting-started/quickstart">
    Build your first monorepo in 5 minutes
  </Card>

  <Card title="Generators" icon="wand-magic-sparkles" href="/frontmcp/nx-plugin/generators/overview">
    Scaffold apps, libs, servers, and components
  </Card>

  <Card title="Executors" icon="play" href="/frontmcp/nx-plugin/executors/overview">
    Build, test, and deploy with Nx
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.