Container Craft

ContainerCraft is a visual drag-and-drop Docker Compose builder that transforms container orchestration from tedious YAML editing into an intuitive design experience.

# The Problem

Docker Compose is essential for modern development, but creating docker-compose.yml files presents significant challenges:

- Beginners struggle with YAML syntax and indentation rules

- Experienced developers waste time writing repetitive boilerplate

- Complex multi-container architectures are difficult to visualize and understand

- Teaching containerization requires jumping between diagrams and configuration files

- Small syntax errors break entire deployments

- No good open-source tools exist for visually building compose configurations

# Our Solution

ContainerCraft provides a web-based visual canvas where developers can design their container architecture by dragging and dropping services, configuring them through intuitive forms, and connecting them visually. The application then generates production-ready docker-compose.yml files automatically.

Think of it as "Figma for Docker" - you design your infrastructure visually, and we handle the YAML complexity.

# Key Features

Visual Canvas with React Flow

- Drag services (nginx, postgres, redis, mongodb, node.js, MySQL, Apache) onto an interactive canvas

- Draw connections between services to define networks and dependencies

- Real-time visual representation of your entire container architecture

- Auto-layout algorithms for clean, organized diagrams

Smart Configuration System

- Form-based editing eliminates the need for YAML syntax knowledge

- Real-time validation catches port conflicts, invalid configurations, and missing dependencies

- Context-aware suggestions based on service types

- Environment variables, volumes, ports, and advanced options are all accessible through a clean UI

Template Library

- Pre-built full-stack templates: LAMP stack, MERN stack, Django+Postgres, and more

- Start with working configurations and customize to your needs

- Save and load your own project templates

- Community-shareable template system

Import & Export

- Import existing docker-compose.yml files for visualization and editing

- Export clean, properly formatted, production-ready YAML

- One-click deployment via Docker SDK integration (optional feature)

- Download or copy to clipboard

Developer Experience

- Modern, beautiful UI built with React 18 and Tailwind CSS

- Comprehensive validation with helpful error messages

- Undo/redo functionality for all actions

- Keyboard shortcuts for power users

- Responsive design works on various screen sizes

# Technical Architecture

Backend: Python 3.10+, FastAPI, PyYAML, Pydantic (data validation), Docker SDK (optional deployment)

Frontend: React 18, React Flow (visual canvas), Tailwind CSS, Axios (API communication)

Architecture Pattern: RESTful API with clean separation between the visual layer and YAML generation logic

Data Flow: User interactions → React state → API calls → YAML generation engine → Validation → Response

# Target Audience & Impact

For Beginners: Learn Docker concepts through visual representation before diving into YAML syntax. See how services connect and understand networking intuitively.

For Educators: Teach containerization with a tool that visualizes concepts. Students grasp architecture before syntax, making learning more effective and engaging.

For Professional Developers: Rapidly prototype multi-container architectures. Generate production-ready configurations without repetitive YAML boilerplate.

For Teams: Document and communicate infrastructure setups with visual diagrams that everyone understands. The diagram becomes living documentation that's always in sync with the actual configuration.

# Why ContainerCraft Matters

We believe infrastructure-as-code tools should be accessible to everyone, not just those comfortable with YAML indentation rules. By removing the syntax barrier and providing visual understanding, ContainerCraft democratizes Docker Compose usage.

This project addresses a real gap in the FOSS ecosystem - there's no good open-source visual tool for building Docker Compose files. Existing solutions are either proprietary, cloud-dependent, or focused on managing running containers rather than creating configurations.

ContainerCraft empowers developers at all skill levels to confidently design, understand, and deploy containerized applications.

Team: Aaryan Chhabra, Arnav Kulkarni, Aniket Kodgirwar, Aaryan Kumbhare

Repository: https://github.com/Kur00o/Container-Craft

License: MIT