Skip to content

Repository files navigation

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

📦 Available Stacks

StackVersionsStatusImage
Flutterv3.32, v3.29, v3.24✅ Stableghcr.io/w3dev/dev-workspaces/flutter:v3.32
React Nativev0.80, v0.79, v0.78✅ Stableghcr.io/w3dev/dev-workspaces/react-native:v0.80
Next.jsv15, v14.2, v14.0✅ Stableghcr.io/w3dev/dev-workspaces/nextjs:v15
Bunv1.2, v1.1, v1.0✅ Stableghcr.io/w3dev/dev-workspaces/bun:v1.2
Denov2.3, v2.0, v1.46✅ Stableghcr.io/w3dev/dev-workspaces/deno:v2.3
Pythonv3.13, v3.12, v3.11✅ Stableghcr.io/w3dev/dev-workspaces/python:v3.13
Gov1.23, v1.22, v1.21✅ Stableghcr.io/w3dev/dev-workspaces/golang:v1.23
AndroidStudio Latest, SDK v34, SDK v33✅ Stableghcr.io/w3dev/dev-workspaces/android:studio-latest

🚀 Quick Start

Using with Gitpod

  1. Add to .gitpod.yml:
image: ghcr.io/w3dev/dev-workspaces/flutter:v3.32tasks:
- init: flutter doctorcommand: flutter run
  1. Open your repository in Gitpod: https://gitpod.io/#https://github.com/YOUR_REPO

Using with GitHub Codespaces

  1. Create .devcontainer/devcontainer.json:
{
"image": "ghcr.io/w3dev/dev-workspaces/react-native:v0.80",
"features": {},
"postCreateCommand": "npm install",
"forwardPorts": [3000, 8081]
}
  1. Open in Codespaces from your GitHub repository

Using with Docker Locally

# 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

📁 Repository Structure

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

🔄 CI/CD & Publishing

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

🛠️ Building Custom Images

Each stack directory contains a Dockerfile that can be customized:

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

📚 Documentation

  • 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

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for:

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

🔐 Security

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

📄 License

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

🙏 Acknowledgments

Built on top of excellent base images from:

  • Gitpod
  • Official language/framework images
  • Community contributions

✨ Contributors

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.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages