chimera-stack-cli 0.1.0

A template-based development environment manager

ChimeraStack CLI

A powerful, template-based development environment manager that simplifies the setup of Docker-based development environments using dynamic port allocation.

Features

✨ Ready-to-Use Templates

• PHP/Nginx Stacks
  • MySQL
  • PostgreSQL
  • MariaDB
• Fullstack Environments
  • React + PHP + MySQL

🔄 Dynamic Port Allocation

• Automatic port assignment to avoid conflicts
• Run multiple projects simultaneously
• Smart port range management:
  • Frontend (React): 3000-3999
  • Backend (PHP/Node): 8000-8999
  • Databases:
    • MySQL: 3300-3399
    • MariaDB: 3400-3499
    • PostgreSQL: 5432-5632
  • Admin Tools:
    • phpMyAdmin: 8081-8180
    • pgAdmin: 8181-8280

🚀 Coming Soon

• Python development environments
• Node.js stacks
• More frontend frameworks
• Additional database options

Quick Start

Installation

pip install chimera-cli

Create a Project

1. Create a new project:

chimera create my-project

2. Choose your template using the interactive arrow-key menu:

? Choose a category:
❯ PHP Development
  Fullstack Development

? Choose a template:
❯ php/nginx/mysql - PHP development environment with Nginx web server and MySQL database
  php/nginx/postgresql - PHP development environment with Nginx web server and PostgreSQL database
  php/nginx/mariadb - PHP development environment with Nginx web server and MariaDB database
  fullstack/react-php/mysql-nginx - Complete fullstack development environment with React, PHP backend, and MySQL database

3. Navigate to your project and start:

cd my-project
docker-compose up -d

Templates

PHP Development

PHP/Nginx/MySQL Stack

• Web server (Nginx + PHP-FPM)
• MySQL Database
• phpMyAdmin
• Pre-configured for PHP development

PHP/Nginx/PostgreSQL Stack

• Web server (Nginx + PHP-FPM)
• PostgreSQL Database
• pgAdmin
• Pre-configured for PHP development

PHP/Nginx/MariaDB Stack

• Web server (Nginx + PHP-FPM)
• MariaDB Database
• phpMyAdmin
• Pre-configured for PHP development

Fullstack Development

React/PHP/MySQL Stack

• React Frontend with hot reload
• PHP Backend (Nginx + PHP-FPM)
• MySQL Database
• phpMyAdmin
• Pre-configured API connectivity

Key Benefits

• 🎯 Zero Configuration: Pre-configured development environments that work out of the box
• 🔄 Dynamic Ports: Smart port allocation to avoid conflicts between projects
• 🔌 Project Isolation: Run multiple projects simultaneously
• 🛠️ Development Ready: Hot-reload, debugging tools, and development utilities included
• 🔒 Secure Defaults: Security best practices configured by default
• 🔄 Consistent Environments: Ensure your team uses the same development setup

Status

ChimeraStack CLI is under active development. We're continuously adding new templates and features to support more development scenarios.

Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details.

Support

For issues, feature requests, or questions:

• Create an issue on GitHub
• Check our documentation
• Join our community discussions

License

This project is licensed under the MIT License - see the LICENSE file for details.