Skip to content

pvagnozzi/PowerContainers

Repository files navigation

🚀 PowerContainers

✨ A curated collection of production-ready development containers for modern software development ✨

License Dev Containers Docker VS Code

📋 Overview

PowerContainers is your ultimate toolkit for modern development! 🎯 This repository provides fully-configured, multi-stage development containers for various programming languages and frameworks. Each container is meticulously crafted to be:

  • 🎨 Highly Customizable - Adapt to your specific needs
  • 🏭 Production-Ready - Enterprise-grade configurations
  • 🚀 Easy to Use - Get started in minutes, not hours
  • 🌍 Cross-Platform - Works on Windows, macOS, and Linux

🎯 Key Features

  • 🐳 Multi-stage Dockerfiles - Optimized layer caching for faster builds
  • 💻 Complete VS Code Integration - Pre-configured with recommended extensions
  • 🛠️ Pre-configured Tooling - Linters, formatters, and debuggers ready to go
  • 👥 Consistent Development Experience - Same environment across all team members
  • 📚 Comprehensive Documentation - Detailed guides for each container
  • Lightning Fast Setup - From clone to code in under 5 minutes
  • 🔒 Security Best Practices - Non-root users and minimal attack surface

📦 Available Containers

Icon Container Description Path
🔧 C++ CMake Modern C++ development with CMake & Ninja containers/cpp-cmake/
📱 Flutter Cross-platform mobile & web development containers/flutter/
🟣 .NET .NET 8+ with Aspire, MAUI & Blazor containers/dotnet/
🐍 Python Python 3.12+ with modern tooling containers/python/
⚛️ React React 18+ with TypeScript & Vite containers/react/
🅰️ Angular Angular 17+ with TypeScript containers/angular/
Ionic Angular Ionic Framework with Angular containers/ionic-angular/
Ionic React Ionic Framework with React containers/ionic-react/

🚀 Quick Start

1️⃣ Install Prerequisites

Automated Installation (Recommended):

Choose your platform and run the installation script:

# Windows (PowerShell as Administrator)
.\scripts\windows\install-prerequisites.ps1

# Linux (with sudo)
sudo ./scripts/linux/install-prerequisites.sh

# macOS (without sudo)
./scripts/macos/install-prerequisites.zsh

📖 Detailed instructions: See INSTALL.md for complete installation guide

What gets installed:

  • ✅ Visual Studio Code + Dev Containers extension
  • ✅ Docker Desktop/Engine
  • ✅ Git and required dependencies
  • ✅ Platform-specific requirements (WSL 2 on Windows, Homebrew on macOS)

2️⃣ Clone the Repository

git clone https://github.com/yourusername/PowerContainers.git
cd PowerContainers

3️⃣ Choose Your Container

cd containers/cpp-cmake  # or any other container
code .

4️⃣ Open in Dev Container

  • Press F1 or Ctrl+Shift+P (or Cmd+Shift+P on macOS)
  • Type and select: Dev Containers: Reopen in Container
  • ⏳ Wait for the container to build (first time only)

5️⃣ Start Coding! 🎉

Your development environment is ready! All tools, extensions, and dependencies are pre-installed and configured.

📖 Documentation

Each container comes with comprehensive documentation including:

  • 📝 Detailed Setup Instructions - Step-by-step guides
  • 🛠️ Available Tools & Extensions - Complete toolchain overview
  • 🎨 Customization Options - Tailor to your needs
  • 💡 Usage Examples - Real-world code samples
  • 🐛 Troubleshooting Guide - Common issues and solutions
  • 🔧 Configuration Tips - Optimization and best practices

🔧 Prerequisites

Automated Installation Available! 🚀

We provide automated installation scripts for all platforms. See INSTALL.md for details.

Manual Installation

If you prefer to install manually:

Tool Description Download Link
🐳 Docker Desktop Container runtime platform Download
💻 Visual Studio Code Code editor (recommended) Download
📦 Dev Containers Extension VS Code extension for containers Install

💡 Tip: On Linux, you can use Docker Engine instead of Docker Desktop

🤝 Contributing

We ❤️ contributions! Whether it's:

  • 🐛 Bug reports
  • 💡 Feature requests
  • 📝 Documentation improvements
  • 🔧 New container templates
  • 🎨 UI/UX enhancements

Please check out our Contributing Guide to get started.

🌟 Contributors

A big thank you to all our contributors! 🙏

📄 License

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

🌟 Show Your Support

If you find PowerContainers useful, please consider:

  • Starring this repository
  • 🔄 Sharing it with your team
  • 🐦 Tweeting about it
  • 💬 Providing feedback through issues

📞 Support & Community

  • 💬 Discussions: Share ideas and ask questions
  • 🐛 Issues: Report bugs or request features
  • 📧 Contact: Reach out for enterprise support

Made with ❤️ for the developer community

🚀 Happy Coding! 🚀

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors