Migration from Standalone

This guide walks you through migrating an existing standalone FrontMCP project into an Nx monorepo.

Overview

Create the workspace

Create a new Nx workspace alongside your existing project:

npx frontmcp create my-platform --nx
cd my-platform

Generate an app for your existing code

nx g @frontmcp/nx:app my-app

This creates apps/my-app/ with the standard structure.

Copy your source files

Copy your existing tools, resources, prompts, and app files into the generated app:

# Copy your source files (adjust paths as needed)
cp -r ../my-standalone/src/tools/* apps/my-app/src/tools/
cp -r ../my-standalone/src/resources/* apps/my-app/src/resources/
cp -r ../my-standalone/src/prompts/* apps/my-app/src/prompts/

Update apps/my-app/src/my-app.app.ts to import all your components:

@App({
  id: 'my-app',
  name: 'MyApp',
  tools: [/* your existing tools */],
  resources: [/* your existing resources */],
  prompts: [/* your existing prompts */],
})
export class MyAppApp {}

Extract shared code into libraries

Identify code that could be shared across future apps:

# Create libraries for shared code
nx g @frontmcp/nx:lib shared-utils
nx g @frontmcp/nx:lib data-models

Move shared utilities into libs/ and update imports using your workspace’s path mappings in tsconfig.base.json.

Update imports

Update imports to use workspace path aliases:

// Before (relative)
import { formatDate } from '../../utils/format';

// After (workspace alias)
import { formatDate } from '@my-platform/shared-utils';

Path aliases are defined in tsconfig.base.json:

{
  "compilerOptions": {
    "paths": {
      "@my-platform/shared-utils": ["libs/shared-utils/src/index.ts"]
    }
  }
}

Generate a server

Create a deployment shell that composes your app:

nx g @frontmcp/nx:server production --apps my-app --deploymentTarget node

Verify everything works

# Development mode
nx dev my-app

# Build
nx build production

# Test
nx test my-app

# Visualize dependencies
nx graph

Checklist

Workspace created with --nx flag
App generated and source files copied
Shared code extracted into libs/
Imports updated to use workspace path aliases
Server generated with correct deployment target
nx dev starts successfully
nx build compiles without errors
nx test passes all tests
Old standalone project can be archived

Get Started

Generators

Executors

Migration from Standalone

Overview

Checklist

​Overview

​Checklist

Overview

Checklist