template: name: "README.md" version: "0.2.7" source: "mak3r-hub://templates/readme" generated: "2025-08-11T15:30:00Z" last_template_update: "2025-08-11T15:30:00Z" manual_edits: true manual_edit_hash: "npm_optimized_features" schema_version: "1.0.0" variables: project_name: "MAK3R-HUB" version: "0.2.7" license: "Commercial" package_size: "55.4kB" features: ["extension-system", "mcp-integration", "on-demand-building"]

MAK3R-HUB v0.2.7 - Universal Claude Code Force Multiplier

The fastest way to create Claude Code-ready development environments.

Transform any development project into an instant-ready Claude Code workspace with a single command: mak3r-hub doctor

🚀 Quick Start

Install

npm install -g mak3r-hub@latest

Create New Project

mak3r-hub create my-app --type ecommerce --framework vue-nuxt
cd my-app

Instant Claude Code Ready State

mak3r-hub doctor
# ✅ Claude Code ready in ~5 seconds

✨ What Makes MAK3R-HUB Special

⚡ 60x Faster Cold Start

• Before: 15+ commands, 5+ minutes, high failure rate
• After: 1 command, ~5 seconds, 100% reliable

🛡️ OS-Aware Safety

• Windows: Batch files, TASKKILL operations, safe process management
• macOS/Linux: Shell scripts, appropriate command alternatives
• Cross-Platform: Automatic OS detection and command validation

🤖 Claude Code Optimized

• Auto-Generated Documentation: Complete CLAUDE.md files for every folder
• Token-Optimized: Minimal verbosity, maximum context clarity
• MCP Integration: Model Context Protocol ready
• Extension System: Dynamic tool loading and management

📁 Complete Project Structure

Every project includes:

my-app/
├── CLAUDE.md                    # Main Claude Code documentation
├── vue-nuxt/ (or react-next/, svelte-kit/)
│   ├── CLAUDE.md               # Framework-specific context
│   └── package.json            # With claude:ready scripts
├── batch-ops/ (Windows) or scripts/ (macOS/Linux)
│   ├── CLAUDE.md               # Operations documentation  
│   ├── launch-my-app.bat/.sh   # Safe server management
│   └── kill-servers.bat/.sh    # Process cleanup
├── domain/
│   └── CLAUDE.md               # Project specifications
├── visual-input/
│   └── CLAUDE.md               # Asset management
└── .mak3r/
    ├── config.json             # Project configuration
    ├── mcp-settings.json        # MCP service settings  
    └── claude-rules.json        # Claude Code integration rules

🎯 Supported Project Types

Website Types

• Landing Page: Marketing sites with conversion optimization
• E-commerce: Full shopping cart functionality
• Portfolio: Professional showcase sites
• Blog: Content management systems
• SaaS: Software-as-a-Service applications

Frameworks

• Vue + Nuxt 3: Server-side rendering, static generation
• React + Next.js: Modern React with full-stack capabilities
• Svelte + SvelteKit: Ultra-fast, compile-time optimized

💻 Usage Examples

Create Different Project Types

# E-commerce store with Vue
mak3r-hub create shop --type ecommerce --framework vue-nuxt

# Portfolio site with React
mak3r-hub create portfolio --type portfolio --framework react-next

# SaaS application with Svelte
mak3r-hub create saas-app --type saas --framework svelte-kit

Claude Code Integration Commands

# Instant ready state (works anywhere in project)
mak3r-hub doctor

# From framework directory (vue-nuxt/, react-next/, etc.)
npm run claude:ready    # Auto-installs MAK3R-HUB if missing
npm run trinity:check   # Quick health check
npm run bootstrap       # Alias for mak3r-hub doctor

Development Workflow

# Windows
batch-ops\launch-my-app.bat     # Start development server
batch-ops\kill-servers.bat      # Clean shutdown

# macOS/Linux  
scripts/launch-my-app.sh        # Start development server
scripts/kill-servers.sh         # Clean shutdown

🔧 Advanced Features

MCP Service Integration

# Start MCP service for advanced Claude Code features
mak3r-hub mcp start --port 3001

# Check service status
mak3r-hub mcp status

# Use MCP commands in Claude Code
# m3r__system__*, m3r__ext__*, trinity__* available

Extension System

# List available extensions
mak3r-hub ext list

# Mount Windows automation tools (Windows only)
mak3r-hub ext mount sharpet

# Execute extension commands
mak3r-hub ext exec sharpet --command gui

# Unmount when done
mak3r-hub ext unmount sharpet

Project Management

# System health check
mak3r-hub doctor

# Configuration management
mak3r-hub config show
mak3r-hub config update

# Development server with debugging
mak3r-hub dev --debug

# One-command deployment
mak3r-hub deploy vercel

📚 Documentation Structure

MAK3R-HUB auto-generates comprehensive documentation:

• Main CLAUDE.md: Project overview, instant bootstrap, OS-specific instructions
• Framework CLAUDE.md: Implementation-specific context and conventions
• Batch-ops CLAUDE.md: Operations and server management documentation
• Domain CLAUDE.md: Project specifications and business logic
• Visual-input CLAUDE.md: Asset management and media guidelines

Each CLAUDE.md file is optimized for Claude Code with:

• Minimal token usage through abstractions
• Clear context boundaries
• OS-aware command validation
• Framework-specific conventions

🛡️ Safety Features

OS Command Validation

• Windows: Prevents Unix commands (bash, sh, ls, cat, grep)
• Unix/Linux: Prevents Windows commands (cmd, TASKKILL, .bat)
• Cross-Platform: Provides appropriate alternatives for each OS

Process Management

• Safe Server Startup: Handles port conflicts and process cleanup
• Graceful Shutdown: Proper process termination without system impact
• Error Recovery: Auto-restart and dependency installation

Security

• MCP Rate Limiting: Prevents service abuse
• Command Sanitization: Input validation and injection prevention
• Extension Isolation: Clean mounting/unmounting without system pollution

🎨 Framework Features

Vue + Nuxt 3

• Server-side rendering and static generation
• Vue 3 Composition API with TypeScript support
• Tailwind CSS integration
• Pinia state management
• Auto-imports and file-based routing

React + Next.js

• App Router with React Server Components
• TypeScript configuration
• Tailwind CSS styling
• Vercel deployment optimization
• API routes and middleware

Svelte + SvelteKit

• Ultra-fast compilation and runtime
• TypeScript and Vite integration
• Adapter-based deployment
• Advanced routing and layouts
• Zero-config optimization

🚀 Performance

Build Optimization

• Tree Shaking: Remove unused code
• Code Splitting: Lazy loading and dynamic imports
• Asset Optimization: Image compression and format conversion
• Bundle Analysis: Size monitoring and optimization suggestions

Development Experience

• Hot Reload: Instant updates during development
• TypeScript: Full type safety and IntelliSense
• Linting: ESLint + Prettier pre-configured
• Testing: Jest and framework-specific test utilities

📦 Installation & Requirements

System Requirements

• Node.js: 16.0.0 or higher
• npm: 7.0.0 or higher
• .NET: 6.0 or higher (for C# automation engine)
• Git: For version control integration

Platform Support

• ✅ Windows 10/11: Full functionality with batch operations
• ✅ macOS: Complete shell script automation
• ✅ Linux: Ubuntu, Debian, CentOS, and other distributions

Global Installation

# Install latest version
npm install -g mak3r-hub@latest

# Verify installation
mak3r-hub --version  # Should show 0.2.6

# Run health check
mak3r-hub doctor

🤝 Contributing

MAK3R-HUB is designed for extensibility:

Extension Development

Create custom extensions for specialized workflows:

// extension.json
{
  "name": "my-extension",
  "version": "1.0.0", 
  "type": "automation-extension",
  "platform": "win32",
  "commands": {
    "deploy": {
      "description": "Deploy to custom platform",
      "executable": "scripts/deploy.exe"
    }
  }
}

Template Customization

Customize project templates for specific needs:

• Framework configurations
• Styling preferences
• Deployment targets
• Development tooling

📖 Documentation

• Getting Started: Complete setup and first project guide
• API Reference: All commands, options, and configurations
• Extension Guide: Creating custom extensions and automations
• Claude Code Integration: Advanced AI development workflows
• Deployment: Platform-specific deployment instructions

🐛 Troubleshooting

Common Issues

# MAK3R-HUB command not found
npm install -g mak3r-hub@latest

# Version mismatch  
mak3r-hub --version  # Should show 0.2.6
npm list -g mak3r-hub

# Health check fails
mak3r-hub doctor  # Shows specific issues

Support

• GitHub Issues: https://github.com/revred/MAK3R-HUB/issues
• Documentation: https://github.com/revred/MAK3R-HUB#readme
• Examples: https://github.com/revred/MAK3R-HUB/tree/main/examples

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Claude Code Team: For AI-assisted development workflows
• Framework Communities: Vue, React, Svelte ecosystems
• Open Source Contributors: Dependencies and inspiration

MAK3R-HUB = Model Access Kit for 3rd-party Resources + HUB

Transform any development project into an instant-ready Claude Code environment.