Dev Container Configuration Generator

WHAT IT DOES

The Dev Container Configuration Generator is a developer tool that creates ready-to-use Docker Compose and dev container configuration files for Ethereum development environments. It generates docker-compose.yml, .devcontainer/devcontainer.json, and a README.md based on user preferences including chain ID, fork block number, RPC URL, and selected development tools (Anvil, Hardhat, Ganache, PostgreSQL, Redis). This helps developers quickly spin up reproducible, containerized development environments for smart contract testing and dApp development without manual configuration.

HOW TO USE

Enter your project name, chain ID, optional fork block number, and RPC URL. Select the development tools you want to include from the list (Anvil is default). Click "generate configuration" to produce three files: docker-compose.yml with all selected services, a devcontainer.json for VS Code development containers, and a README.md with setup instructions. Each file can be downloaded individually or copied directly from the display. The tool automatically configures Anvil with the specified chain ID and fork parameters, and adds additional services based on your selections.

TECHNICAL MECHANISM

The tool generates YAML and JSON configurations using template-based string construction. For Docker Compose, it builds a services object containing the base Anvil service and any additional selected tools. Each service is defined with the appropriate Docker image, container name, ports, and command. Anvil is configured with --chain-id, --host 0.0.0.0, and optional --fork-block-number and --fork-url parameters. Additional tools are mapped to their respective images: Hardhat (node:18-alpine with npx hardhat node), Ganache (trufflesuite/ganache), PostgreSQL (postgres:15-alpine with environment variables), and Redis (redis:7-alpine). The devcontainer.json is generated with the appropriate features and VS Code extensions for Solidity development. All files are presented in the UI with syntax highlighting and download buttons.

WHAT IT CANNOT SEE

The tool cannot automatically install or run containers. It cannot validate that generated configurations will work with the user's local Docker setup or detect port conflicts on the user's machine. The tool cannot verify that the RPC URL is accessible from within the container or guarantee compatibility with all operating systems or Docker versions. It cannot test the generated configuration for correctness without execution. The tool cannot handle complex multi-service dependencies beyond the basic template. It cannot detect whether the user's system has Docker installed or whether the required Docker images are available.

PLEASE NOTE

This tool is designed for Ethereum Virtual Machine (EVM) compatible chains but works with any EVM chain by setting the appropriate chain ID. The generated configurations assume Docker and Docker Compose are installed on the user's system. The Anvil image from ghcr.io/foundry-rs/foundry is used by default; ensure your system can pull this image. The tool provides a foundation for development environments—users may need to adjust ports, add volumes, or modify configurations for their specific needs. Always review generated files before running them in production or shared environments.