This repo hosts reusable devcontainer templates for projects and teams.

Use a template by referencing its image in devcontainer.json:

{
  "name": "My Project",
  "image": "ghcr.io/lloydrichards/devcontainer-templates/web-app:latest"
  // "features": { ...  },
  // "customizations": { ...  }
}

Template IDs map to src/ folder names and GHCR image names.

Pin a version by replacing latest with a published tag (for example :v0.3.1).

• src/<template-id>: Template definitions.
• test/<template-id>: Template tests.

1. Copy an existing template folder in src/.
2. Update devcontainer-template.json and .devcontainer/devcontainer.json.
3. Add a test in test/<template-id>/test.sh.
4. Add docs in docs/templates/<template-id>.md and update the catalog.

Publishing will use devcontainer templates publish to GHCR. The workflow will be added once the initial set of templates is stable.