gund / devcontainers-contrib-features

🐳 Extra add-in features for Devcontainers and GitHub Codespaces

Community devcontainer features

🐳 Extra add-in features for devcontainers and GitHub Codespaces

Overview | User docs | Contributing | Developer wiki

💻 Works with devcontainers
☁️ Works with GitHub Codespaces
👨‍🍳 Based on the official devcontainers/template-starter project

📢 We are actively seeking contributions!

Usage

📄 View the full list of features

Just add a .devcontainer/devcontainer.json file with a features key. It's very similar to NPM's package.json and dependencies object, just with the addition of an options object.

📚 Make sure to inspect each feature for feature-specific options
⚠️ We only officially support debian-based images

{
  "image": "mcr.microsoft.com/devcontainers/universal:linux",
  "features": {
    "ghcr.io/devcontainers-contrib/features/deno:latest": {},
    "ghcr.io/devcontainers-contrib/features/mkdocs:latest": {},
    "ghcr.io/devcontainers-contrib/features/conan:latest": {},
    "ghcr.io/devcontainers-contrib/features/bikeshed:latest": {}
  }
}

💡 Pro tip: You can use a string instead of an object as a shortcut to { "version": "<your string>" }!

{
  "features": {
    "ghcr.io/devcontainers-contrib/features/deno:latest": "1.24.0",
    "ghcr.io/devcontainers-contrib/features/pulumi:latest": "3.48.0"
  }
}

Development

📢 We are actively seeking contributions!

This repository is heavily based on the devcontainers/template-starter project. You can find more developer-specific docs on the Wiki