Dev Container

No Change
adopt
First Added:April 23, 2025 Updated: July 29, 2026

Dev Container. (devcontainer.json + image) define a reproducible dev environment in OCI: toolchain, extensions, and settings live in the repo instead of on each laptop.

Blurb

Development containers documentation and specification page.

Summary

Garden stance: We adopt Dev Container for our estate.

Key points:

TopicNotes
SecretsUse env files or secret mounts; never bake credentials into the image
PerformanceMount workspace with delegated volumes on macOS; cache package dirs
CIBuild/test inside the same Dockerfile in GitHub Actions
AgentsCursor / cursor-agent run inside the container when the editor attaches
IaC linkTreat the dev image like Declarative IaC for the toolchain

References

Details

TopicNotes
SecretsUse env files or secret mounts; never bake credentials into the image
PerformanceMount workspace with delegated volumes on macOS; cache package dirs
CIBuild/test inside the same Dockerfile in GitHub Actions
AgentsCursor / cursor-agent run inside the container when the editor attaches
IaC linkTreat the dev image like Declarative IaC for the toolchain

References