🚀 Claude Code Configs

Production-ready Claude Code configurations for popular frameworks and tools

🎉 Version 1.0.0 - Production-ready with comprehensive testing and 124 passing tests 📦 NPM Package - Install with npm install -g claude-config-composer or use npx

🚨 Breaking Changes for Existing Users

This release fundamentally changes how configs are organized and used.

• ✅ Migration Guide Available: MIGRATION.md
• 🔄 Individual configs moved to configurations/ directory
• 🎯 New CLI tool for intelligent config merging
• ⚠️ Direct directory copying is deprecated

🎯 Key Features

• ✅ 124 Passing Tests - Comprehensive test coverage
• ✅ 8+ Production Configurations - Frameworks, UI libraries, databases, MCP servers, and tools
• ✅ Intelligent Merging - Combine multiple configs without conflicts
• ✅ Zero Dependencies (runtime) - Lightweight and fast
• ✅ TypeScript - Full type safety and modern development
• ✅ Git Integration - Automatic .gitignore updates and backups

Report Issues

Found a bug? Please report it at GitHub Issues

🎯 Two Ways to Use This Repository

1. 🚀 Generate Combined Configs (Recommended)

Quick Start with NPX (No Installation Required):

# Generate configs directly in your project
npx claude-config-composer nextjs-15 shadcn

# Or use interactive mode
npx claude-config-composer

Global Installation:

# Install globally for frequent use
npm install -g claude-config-composer

# Then use from any project
claude-compose nextjs-15 shadcn tailwindcss

Local Development (For Contributors):

# Clone and set up the composer
git clone https://github.com/Matt-Dionis/claude-code-configs.git
cd claude-code-configs/claude-config-composer
npm install && npm run build

# Generate configs from your project directory
cd /path/to/your/project
node /path/to/claude-code-configs/claude-config-composer/dist/cli.js nextjs-15 shadcn

✨ Features:

• Intelligently merges multiple configs
• Automatic backups of existing configs
• Git-friendly (auto-adds to .gitignore)
• Production-ready output
• Zero installation (once published to npm)

2. 📁 Manual Copy Individual Configs

For single framework setups:

# Copy a specific configuration to your project
cp -r configurations/frameworks/nextjs-15/.claude your-project/
cp configurations/frameworks/nextjs-15/CLAUDE.md your-project/

Available configurations:

Frameworks:

• nextjs-15 - Next.js 15 with App Router and React 19

UI & Styling:

• shadcn - shadcn/ui component library with Radix UI
• tailwindcss - Utility-first CSS framework with responsive design

Databases:

• drizzle - Type-safe ORM with schema management and migrations

Development Tools:

• vercel-ai-sdk - Streaming AI applications with function calling

MCP Servers (Complete Solutions):

• memory-mcp-server - MCP server with vector search and persistence
• token-gated-mcp-server - Token-gated MCP server using the Radius MCP SDK

📸 What Gets Generated - Before & After Example

Before: Empty Project Directory

your-nextjs-project/
├── app/
├── components/
├── package.json
└── next.config.js

After: Running npx claude-config-composer nextjs-15 shadcn tailwindcss

your-nextjs-project/
├── app/
├── components/
├── package.json
├── next.config.js
├── CLAUDE.md                   # ✨ Combined best practices from all configs
└── .claude/                    # ✨ Generated configuration
    ├── agents/
    │   ├── nextjs-app-router.md         # Next.js routing expertise
    │   ├── component-builder.md         # shadcn component patterns
    │   ├── responsive-designer.md       # Tailwind responsive design
    │   └── ... (20+ more specialized agents)
    ├── commands/
    │   ├── create-page.md               # Generate Next.js pages
    │   ├── add-component.md             # Add shadcn components
    │   ├── optimize-styles.md           # Tailwind optimization
    │   └── ... (15+ workflow commands)
    ├── hooks/
    │   ├── format-code.sh               # Auto-format on save
    │   ├── validate-components.sh       # Component validation
    │   └── optimize-imports.sh          # Import optimization
    └── settings.json                    # Merged permissions & env vars

🎯 Key Benefits of Generated Config

• 40+ specialized agents covering Next.js, shadcn, and Tailwind expertise
• Intelligent permission controls tailored to your stack
• Automated workflows via hooks for formatting, validation, and optimization
• Zero conflicts - all configurations intelligently merged
• Production-ready - works immediately with Claude Code

📁 Repository Structure

claude-config-composer/         # 🔧 Dynamic config generator CLI tool
├── src/
│   ├── cli.ts                 # Interactive CLI interface
│   ├── parser/                # Config parsing logic
│   ├── merger/                # Intelligent merging
│   └── generator/             # .claude directory generation
└── README.md                  # Tool documentation

configurations/                 # 📦 All Claude Code configurations
├── frameworks/                 # Framework-specific configurations
│   └── nextjs-15/             # Next.js 15 with App Router & React 19
│       ├── .claude/           # Complete config with agents, commands, hooks
│       ├── CLAUDE.md          # Next.js 15 development patterns
│       └── README.md          # Setup and usage guide
├── ui/                        # UI library and styling configurations
│   ├── shadcn/                # shadcn/ui component library
│   │   ├── .claude/           # UI development agents and commands
│   │   ├── CLAUDE.md          # Component patterns and best practices
│   │   └── README.md          # Installation and setup guide
│   └── tailwindcss/           # Utility-first CSS framework
│       ├── .claude/           # Styling and design system agents
│       ├── CLAUDE.md          # Tailwind patterns and optimization
│       └── README.md          # Configuration and usage guide
├── databases/                  # Database and ORM configurations
│   └── drizzle/               # Type-safe ORM with migrations
│       ├── .claude/           # Database development agents
│       ├── CLAUDE.md          # Schema management and query patterns
│       └── README.md          # Setup and migration guide
├── tooling/                   # Development tools and SDKs
│   └── vercel-ai-sdk/         # AI application development
│       ├── .claude/           # AI development agents and workflows
│       ├── CLAUDE.md          # Streaming and function calling patterns
│       └── README.md          # SDK setup and usage guide
└── mcp-servers/               # Complete MCP server solutions
    ├── memory-mcp-server/     # Memory-enabled MCP server
    │   ├── .claude/           # Full-stack development agents
    │   ├── CLAUDE.md          # Vector search and persistence patterns
    │   └── README.md          # Complete setup guide
    └── token-gated-mcp-server/ # Authentication-enabled MCP server
        ├── .claude/           # Security and auth agents
        ├── CLAUDE.md          # Token management and security patterns
        └── README.md          # Authentication setup guide

docs/                          # 📚 Documentation and guides
├── claude-code-github-actions.md
├── claude-code-sdk.md
├── get-started-with-claude-code-hooks.md
└── [other documentation files]

# 🚧 Coming Soon:
# configurations/
# ├── frameworks/
# │   ├── react-19/           # Standalone React 19 patterns
# │   └── svelte-5/           # SvelteKit 2.0 configuration
# ├── databases/
# │   ├── prisma/             # Alternative ORM configuration
# │   └── supabase/           # Backend-as-a-Service setup
# ├── testing/
# │   ├── vitest/             # Fast testing framework
# │   └── playwright/         # E2E testing configuration
# └── tooling/
#     ├── zod/                # Schema validation patterns
#     └── trpc/               # End-to-end type safety

🚀 Quick Start with Claude Config Composer

Install and Use

# Quick start with npx (no installation)
npx claude-config-composer nextjs-15 shadcn tailwindcss

# Or install globally
npm install -g claude-config-composer

# Then use the short alias
claude-compose nextjs-15 shadcn

Common Commands

# Interactive mode - choose configs visually
npx claude-config-composer

# List all available configurations
npx claude-config-composer list

# Generate full-stack configuration
npx claude-config-composer nextjs-15 shadcn tailwindcss drizzle vercel-ai-sdk

# AI development stack
npx claude-config-composer vercel-ai-sdk drizzle

# Preview without creating files
npx claude-config-composer dry-run nextjs-15 shadcn

# Validate existing configuration
npx claude-config-composer validate

What Gets Generated

A complete .claude/ directory in your project with:

• Combined agents from all selected configs
• Merged commands and hooks
• Unified settings.json
• Comprehensive CLAUDE.md documentation

🎯 Available Configurations

Memory MCP Server Configuration

A production-grade configuration for building MCP servers with memory persistence and vector search:

• 15 Specialized Agents for MCP, database, and memory systems
• 7 Custom Commands for development workflows
• 2 Automation Hooks for TypeScript and logging
• Optimized for: PostgreSQL 17, pgvector, Drizzle ORM, MCP SDK

View Memory MCP Server Details →

🎯 Framework-Specific Configurations

Next.js 15 Configuration

A complete Claude Code configuration tailored for Next.js 15 development, including:

Specialized Next.js Agents (11 total)

Core Development:

• nextjs-app-router - App Router routing patterns and best practices
• nextjs-server-components - Server/Client component optimization
• nextjs-server-actions - Forms, mutations, and progressive enhancement
• nextjs-data-fetching - Caching strategies and streaming
• nextjs-performance - Bundle analysis and Core Web Vitals

Infrastructure & Quality:

• nextjs-testing - Jest, Vitest, Playwright setup
• nextjs-deployment - Docker, Vercel, AWS deployment
• nextjs-migration - Pages Router to App Router migration
• nextjs-security - Authentication, CSP, OWASP compliance
• nextjs-debugging - React DevTools and troubleshooting
• nextjs-typescript - Type safety and error resolution

Next.js Commands (6 total)

/create-page [route]          # Generate page with loading/error boundaries
/create-server-action [name]  # Create type-safe Server Actions
/optimize-components          # Analyze component boundaries
/setup-testing [framework]    # Configure testing framework
/analyze-performance          # Generate performance report
/migrate-to-app-router        # Migrate from Pages Router

Key Features

• React 19 & Async Request APIs - Full support for Next.js 15 breaking changes
• Server Components First - Optimized for minimal client JavaScript
• Intelligent Validation - Pre-commit hooks for Next.js patterns
• Best Practices Enforcement - Automated checks for common mistakes
• Complete Documentation - CLAUDE.md with Next.js 15 patterns

🛠️ Featured Commands

Memory MCP Server Commands

/setup quick       # Quick MCP project setup
/setup full        # Complete environment with dependencies
/setup database    # PostgreSQL & pgvector initialization
/mcp-debug        # Debug MCP protocol issues
/memory-ops       # Test memory CRUD operations

Next.js 15 Commands

/create-page              # Generate page with boundaries
/create-server-action     # Create type-safe Server Actions
/optimize-components      # Analyze component boundaries
/analyze-performance      # Generate performance report
/migrate-to-app-router    # Migrate from Pages Router

⚡ Shared Features

Automation Hooks

Both configurations include intelligent hooks:

• TypeScript Development - Auto type-check, format, lint
• Command Logging - Audit trail with timestamps
• Smart Filtering - Skip node_modules, build directories
• Test Automation - Run tests on file changes

Security Best Practices

All configurations enforce:

• 🔒 Whitelist approach for commands
• 🚫 Protected sensitive files (.env, secrets)
• ✅ Scoped write permissions by file type
• 🛡️ Safe git operations (no force push)
• 🔐 Input validation with Zod schemas

💡 Use Cases & Examples

1. Memory MCP Server Development

Use the memory-mcp-server configuration for:

• Building MCP servers with persistent memory storage
• Implementing vector search with pgvector and OpenAI embeddings
• Creating multi-tenant AI companion systems
• Setting up production PostgreSQL with Neon
• Deploying with Docker and Kubernetes

2. Next.js 15 Application Development

Use the nextjs-15 configuration for:

• Setting up new Next.js 15 projects wi