DevContainer Features

Reusable, production-ready DevContainer Features for cloud, full-stack, DevOps, and infrastructure development environments.
Modular, portable, and compatible with Amazon Linux, Ubuntu, and Debian-based systems.

Compatible with: Amazon Linux • Ubuntu • Debian

Features Included

• Shell Environment – Fully customizable Zsh setup with:

  • Zsh and Oh My Zsh
  • Powerlevel10k theme
  • Zsh autosuggestions and syntax highlighting
  • Nerd Font v3 (Meslo)
  • Timezone configuration
  • Optional opinionated configuration
  • Override support via .zshrc and .p10k.zsh URLs
  • Post-install script hook

• AWS CLI v2

• Terraform (with tfswitch)

• OpenTofu (Terraform fork)

• Python (via pyenv, with optional pipenv)

• Node.js (via nvm)

• Pre-commit (Hooks setup)

Each tool is packaged as an independent, composable DevContainer Feature.

Usage

You can reference features from this repository directly using the gh: prefix in your devcontainer.json:

{
  "features": {
    "gh:jonmatum/devcontainer-features/python:1.0.0": {
      "version": "3.11.9",
      "pipenv": true
    },
    "gh:jonmatum/devcontainer-features/aws:1.0.0": {},
    "gh:jonmatum/devcontainer-features/terraform:1.0.0": {},
    "gh:jonmatum/devcontainer-features/shell:1.1.0": {
      "timezone": "America/New_York",
      "opinionated": true,
      "zshrcUrl": "https://example.com/.zshrc",
      "p10kUrl": "https://example.com/.p10k.zsh"
    }
  }
}

Replace the feature ID and version according to your requirements.

Feature Highlights

Each DevContainer Feature is:

• Composable – Add only the tools you need
• Opinionated, but overridable – Defaults provided, but easy to customize
• Reusable – Designed for local dev, CI/CD, and cloud workspaces
• Tested – Verified against multiple base images and distros

Structure

Each Feature is organized under the src/ folder following the DevContainer Feature distribution specification.

src/
  shell/
    devcontainer-feature.json
    install.sh
    NOTES.md
  aws/
    devcontainer-feature.json
    install.sh
  python/
    devcontainer-feature.json
    install.sh
  terraform/
    devcontainer-feature.json
    install.sh
  opentofu/
    devcontainer-feature.json
    install.sh
  node/
    devcontainer-feature.json
    install.sh

Versioning

Each Feature is individually versioned using the version attribute in its devcontainer-feature.json. Versioning follows Semantic Versioning (SemVer).

{
  "id": "shell",
  "version": "1.1.0",
  ...
}

Releases are automated via GitHub Actions using release-please, generating a changelog and GitHub Release per update.

Publishing

Features are automatically published to GitHub Container Registry (GHCR) following the DevContainer Feature distribution spec.

• Each Feature is published individually under:
  ghcr.io/jonmatum/devcontainer-features/<feature>:<version>

• A collection metadata package is also published:
  ghcr.io/jonmatum/devcontainer-features

Important: After publishing, Features must be manually marked as Public in the GitHub Package settings to be discoverable and usable.

Example URLs:

• Feature: Shell Feature Package
• Collection: Feature Collection

License

This project is MIT License. Originally scaffolded from Microsoft’s Dev Container Feature starter kit.
Extended and maintained by Jonatan Mata, 2025.

Additional Resources

For advanced configuration, usage examples, and feature-specific notes, refer to the NOTES.md file within each feature’s folder.

---

echo "Pura Vida & Happy Coding!";