FrontMCP Setup Router

Entry point for project setup and scaffolding. This skill helps you find the right setup guide based on your project needs — from initial scaffolding to storage backends, project structure, and multi-app composition.

When to Use This Skill

Must Use

• Starting a new FrontMCP project from scratch and need to choose between standalone vs Nx monorepo
• Setting up storage backends (Redis, SQLite) for session or state management
• Organizing an existing project and need canonical directory layout guidance

Recommended

• Onboarding to the FrontMCP project structure and naming conventions
• Setting up multi-app composition within a single server
• Understanding the skills system and how to browse, install, and manage skills

Skip When

• You need to build specific components like tools or resources (see frontmcp-development)
• You need to configure transport, auth, or throttling (see frontmcp-config)
• You need to deploy or build for a target platform (see frontmcp-deployment)

Decision: Use this skill when you need to CREATE or ORGANIZE a project. Use other routers when you need to build, configure, deploy, or test.

Prerequisites

• Node.js 24+ and npm/yarn installed
• frontmcp CLI available globally (npm install -g frontmcp)

Steps

1. Use the Scenario Routing Table below to find the right setup guide for your task
2. Scaffold your project with frontmcp create (standalone) or frontmcp create --nx (monorepo)
3. Configure storage and project structure per the relevant reference files
4. Follow the Recommended Reading Order for a complete setup walkthrough

Scenario Routing Table

Recommended Reading Order

1. references/setup-project.md — Start here for any new project
2. references/project-structure-standalone.md or references/project-structure-nx.md — Choose your layout
3. references/setup-redis.md or references/setup-sqlite.md — Add storage if needed
4. references/multi-app-composition.md — Scale to multiple apps (when needed)
5. references/nx-workflow.md — Nx-specific build and CI commands (if using Nx)
6. references/frontmcp-skills-usage.md — Learn the skills system
7. references/readme-guide.md — Generate README for your deployment target

Cross-Cutting Patterns

Common Patterns

Verification Checklist

Project Structure

• main.ts exists with export default of @FrontMcp class
• At least one @App class registered in the server
• Files follow <name>.<type>.ts naming convention
• Test files use .spec.ts extension

Storage

• Storage backend chosen and configured (Redis/SQLite/memory)
• Connection string in environment variables, not hardcoded
• Storage accessible from the server process

Build and Dev

• frontmcp dev starts successfully with file watching
• frontmcp build --target <target> completes without errors
• Tests pass with frontmcp test or nx test

Troubleshooting

Reference

• Getting Started
• Domain routers: frontmcp-development, frontmcp-deployment, frontmcp-testing, frontmcp-config, frontmcp-guides