Dev Container Features

This repository contains a collection of features that can be used to enhance the development experience in a Visual Studio Code Dev Container.

The features are organized in separate folders and can be used individually in a devcontainer.json file.

Installation

The installation script can be run locally and/or in a devcontainer environment.

When run locally:

• Features are installed in the local environment.
• A devcontainer.json file is optionally created for the remote development experience.

npx tomgrv/devcontainer-features -h

To install only root stubs

npx tomgrv/devcontainer-features -- init

To install a specific devcontainer feature

npx tomgrv/devcontainer-features -- add gitutils

To set up a full dev environment

npx tomgrv/devcontainer-features -- add -a

Features Overview

Feature	Description
GitUtils	Git aliases and workflow automation
GitHooks	Commit hooks: commitlint, prettier, lint-staged
GitVersion	Semantic versioning via GitVersion
Act	Run GitHub Actions locally via nektos/act
PECL	PHP extension installer via PECL
Larasets	Laravel-specific development utilities
Common Utils	Shared utilities used by other features
Gateway	SSL certificate management for corporate networks
Minikube	Local Kubernetes cluster via Minikube

---

GitUtils

A collection of Git aliases, git-flow shortcuts, and interactive utilities for automating Git workflows.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gitutils:5": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add gitutils

---

GitHooks

Configures Git hooks in one step using commitlint, commitizen, lint-staged, prettier, and devmoji.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/githooks:5": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add githooks

---

GitVersion

Installs GitVersion to calculate semantic version numbers from your Git history.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gitversion:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add gitversion

---

Act

Installs nektos/act to run GitHub Actions locally inside the dev container.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/act:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add act

---

PECL

Installs PHP extensions from the PHP Extension Community Library (PECL).

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/pecl:5": {
        "extension": "zip"
    }
}

Quick Install — console

npx tomgrv/devcontainer-features -- add pecl

---

Larasets

Laravel-specific settings, shell utilities, Composer scripts, and VS Code extensions for Laravel development.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/larasets:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add larasets

---

Common Utils

Shared utilities (jq, dos2unix, JSON helpers, logging) used by other features in this collection.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/common-utils:5": {
        "utils": "jq dos2unix"
    }
}

Quick Install — console

npx tomgrv/devcontainer-features -- add common-utils

---

Gateway

Handles SSL inspection certificates for corporate network environments (e.g. Zscaler). Installs the root CA and wraps curl for transparent gateway authentication.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/gateway:5": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add gateway

---

Minikube

Installs Minikube to run a single-node Kubernetes cluster locally inside the dev container.

📖 Full documentation

Quick Start — devcontainer.json

"features": {
    "ghcr.io/tomgrv/devcontainer-features/minikube:6": {}
}

Quick Install — console

npx tomgrv/devcontainer-features -- add minikube

---

Contributing

If you have a feature that you would like to add to this repository, please open an issue or submit a pull request.

License

This repository is licensed under the MIT License.