index.md

layout	home
hero	name text tagline actions create-polyglot Polyglot Monorepo Scaffolder Generate Node, Python, Go, Java Spring Boot & Next.js services in one workspace with hot reload, shared libraries, and Docker support. theme text link brand Get Started /guide/getting-started theme text link alt CLI Reference /cli/ theme text link alt View on GitHub https://github.com/kaifcoder/create-polyglot
features	icon title details 🚀 Multi-Language Support Spin up services across Node.js, Python/FastAPI, Go, Java Spring Boot & Next.js frontend with support for modern frameworks like Remix, Astro, and SvelteKit. icon title details 🔄 Hot Reload Aggregator Unified hot reload system that automatically restarts Node, Python (uvicorn), Go, Java Spring Boot services, and provides HMR for Next.js and other frontends. icon title details 📦 Shared Libraries Create and manage shared code across services with language-specific libraries for Python packages, Go modules, and Java JARs. icon title details 🎯 Preset Aware Choose between Turborepo or Nx for advanced monorepo orchestration, or use the zero-config basic runner for simple projects. icon title details 🐳 Docker Ready Auto-generated Dockerfiles & docker-compose.yaml for rapid container workflows. Start all services with a single command. icon title details 🔌 Extensible Plugin System Powerful plugin architecture with lifecycle hooks to customize and extend the CLI workflow. Create plugins to integrate with external tools. icon title details 📊 Admin Dashboard Real-time log streaming dashboard with file watching and WebSocket updates. Monitor all your services from a single interface. icon title details ⚙️ Service Management Add, remove, and manage services post-initialization. Start, stop, restart, and view logs for individual services with granular control.

Quick Start

# Install globally
npm install -g create-polyglot

# Create a new project with interactive wizard
create-polyglot init my-org

# Or skip prompts with flags
create-polyglot init my-org -s node,python,go,frontend --preset turborepo --git --yes

# Start development
cd my-org
create-polyglot dev

# Enable hot reload for all services
create-polyglot hot

# Launch admin dashboard
create-polyglot admin

Why create-polyglot?

Building a production-ready polyglot microservice environment typically requires:

• ✅ Repetitive boilerplate across multiple languages
• ✅ Manual Docker configuration and orchestration
• ✅ Complex monorepo tooling setup
• ✅ Service discovery and management infrastructure
• ✅ Shared code patterns and utilities

create-polyglot automates all of this, giving you:

• 🎯 Consistent folder layout & service naming
• 📝 Battle-tested language starter templates
• 🔧 Pre-configured monorepo orchestration (Turborepo/Nx)
• 🐳 Auto-generated Dockerfiles & compose configurations
• 🔌 Extensible plugin system for custom workflows
• 📊 Centralized configuration via polyglot.json

Perfect for prototyping architectures, onboarding teams faster, or creating reproducible demos and PoCs.

What's New in v1.19

• 🔥 Unified Hot Reload System - Automatic restart/HMR across all service types
• 📊 Admin Dashboard - Real-time log streaming with WebSocket support
• 🔌 Enhanced Plugin System - Comprehensive lifecycle hooks and external plugin support
• 📦 Shared Libraries - Language-specific library generation (Python, Go, Java)
• 🎛️ Service Controls - Granular start/stop/restart/logs commands
• 🚀 Modern Frontend Support - Remix, Astro, and SvelteKit templates
• ⚡ Performance Improvements - Faster scaffolding and better error handling

Documentation Structure

📚 Guide

Learn the fundamentals and best practices:

• Getting Started - Installation and first steps
• Presets - Turborepo, Nx, or Basic runner
• Docker & Compose - Container workflows
• Shared Libraries - Cross-service code reuse
• Frontend Frameworks - Remix, Astro, SvelteKit

💻 CLI Reference

Complete command documentation:

• Usage - All available commands
• Admin Dashboard - Dashboard features and usage
• Flags - Command-line options

🔧 Configuration

Project configuration reference:

• polyglot.json - Schema and options

📝 Templates

Language-specific template details:

• Node.js - Express API template
• Python - FastAPI template
• Go - net/http template
• Java - Spring Boot template
• Frontend - Next.js template

⚡ Features

Advanced features:

• Service Logs - Log management
• Plugin System - Extensibility
• Service Controls - Process management
• Hot Reload - Auto-restart/HMR

Community & Support

• 💬 GitHub Discussions - Ask questions and share ideas
• 🐛 Issue Tracker - Report bugs and request features
• 📖 Contributing Guide - Help improve the project
• ⭐ Star on GitHub - Show your support

License

MIT Licensed - Free and open source forever.