Dev Workspaces - Multi-Platform Development Environments

🚀 Repository Restructuring in Progress - We're expanding from Gitpod-only to support multiple platforms!

This repository provides optimized Docker images for various development stacks, compatible with:

• Gitpod - Cloud development environments
• GitHub Codespaces - Via Devcontainers specification
• OpenAI Codex - AI-assisted development
• Local Docker - Traditional development workflows

1. Add to .gitpod.yml:

image: ghcr.io/w3dev/dev-workspaces/flutter:v3.32
tasks:
 - init: flutter doctor
 command: flutter run

2. Open your repository in Gitpod: https://gitpod.io/#https://github.com/YOUR_REPO

1. Create .devcontainer/devcontainer.json:

{
 "image": "ghcr.io/w3dev/dev-workspaces/react-native:v0.80",
 "features": {},
 "postCreateCommand": "npm install",
 "forwardPorts": [3000, 8081]
}

2. Open in Codespaces from your GitHub repository

# Pull and run
docker pull ghcr.io/w3dev/dev-workspaces/python:v3.13
docker run -it -v $(pwd):/workspace ghcr.io/w3dev/dev-workspaces/python:v3.13
# With port forwarding
docker run -it -p 8000:8000 -v $(pwd):/workspace ghcr.io/w3dev/dev-workspaces/python:v3.13

dev-workspaces/
├── flutter/ # Flutter development environments
│ ├── v3.32/
│ ├── v3.29/
│ └── v3.24/
├── react-native/ # React Native + Expo environments
├── nextjs/ # Next.js full-stack environments
├── bun/ # Bun JavaScript runtime
├── deno/ # Deno JavaScript runtime
├── python/ # Python development environments
├── golang/ # Go development environments
├── android/ # Android SDK and Studio
├── templates/ # Reusable templates
├── legacy/ # Previous Gitpod-only images
└── .github/
 └── workflows/ # CI/CD automation

Images are automatically built, tested, and published to multiple registries:

• GitHub Container Registry (Primary): ghcr.io/w3dev/dev-workspaces/*
• Docker Hub: docker.io/w3dev/dev-workspaces/*
• GitLab Container Registry: registry.gitlab.com/w3dev/dev-workspaces/*
• Quay.io: quay.io/w3dev/dev-workspaces/*
• Harbor: Custom enterprise registry

Each stack directory contains a Dockerfile that can be customized:

cd flutter/v3.32
docker build -t my-flutter-dev .

• Each stack has its own README with detailed information
• Version-specific documentation in each version directory
• Migration Guide for transitioning from old structure
• Contributing Guidelines for contributors

We welcome contributions! Please see our Contributing Guidelines for:

• Adding new technology stacks
• Updating existing images
• Improving documentation
• Reporting issues

• All images are regularly scanned for vulnerabilities
• Base images are updated weekly
• Security patches are applied promptly
• Report security issues to: security@w3dev.io

This repository is licensed under the MIT License. Individual software packages included in the images are subject to their own licenses.

Built on top of excellent base images from:

• Gitpod
• Official language/framework images
• Community contributions

Thanks to all the amazing contributors who have helped make this project better!

Made with contrib.rocks.

Note: This repository was previously focused solely on Gitpod workspaces. Legacy images are preserved in the /legacy directory for backward compatibility.