StackForDev

Docker as your dev environment. Select a language and stack, get a tailored Dockerfile — no local language installation required.

Instead of installing Python, Node, Go, Rust, or Java on your machine, StackForDev generates a Dockerfile that acts as a transparent runtime proxy. You run commands inside the container against your volume-mounted project files. Your host stays clean.

Quick Start

pip install stackfordev

# Bootstrap a complete dev workspace in one command
stackfordev init -l python -s "Django Stack" -v 3.12

# Then:
docker compose build
source devrun.sh
devrun python manage.py runserver

Or just generate a Dockerfile:

stackfordev generate -l python -s "Django Stack" -v 3.12 --compose -o ./Dockerfile

Usage

# Bootstrap a full workspace (Dockerfile + docker-compose.yml + .dockerignore + devrun.sh)
stackfordev init -l python -s "Django Stack" -v 3.12
stackfordev init  # interactive mode

# Interactive mode (prompts for missing options)
stackfordev generate

# Non-interactive
stackfordev generate -l python -s "Django Stack" -v 3.12

# With extra dependencies
stackfordev generate -l python -s "Data Science Stack" -v 3.11 -e "numpy,pandas,scikit-learn"

# Save to file
stackfordev generate -l go -s "Gin Stack" -v 1.23 -o ./Dockerfile

# Also generate docker-compose.yml and .dockerignore
stackfordev generate -l python -s "Django Stack" -v 3.12 --compose -o ./Dockerfile

# Generate offline (no API call)
stackfordev generate -l javascript -s "Express Stack" -v 22 --local

# Raw JSON output
stackfordev generate -l rust -s "Actix-Web Stack" -v 1.82 --json

# Show all supported languages, versions, and stacks
stackfordev info

Supported Languages & Stacks

Use stackfordev info for a live table. Summary:

CLI Options

stackfordev generate [OPTIONS]

  -l, --language TEXT    Programming language
  -s, --stack TEXT       Dependency stack (e.g. 'Django Stack')
  -v, --version TEXT     Language version (e.g. 3.12)
  -e, --extras TEXT      Comma-separated extra dependencies
  -o, --output PATH      Save Dockerfile to path
  --compose              Also generate docker-compose.yml and .dockerignore
  --local                Generate offline without API call
  --json                 Output raw JSON response
  --help                 Show this message and exit.

stackfordev info        Show supported languages, versions, and stacks

stackfordev init [OPTIONS]

  -l, --language TEXT    Programming language
  -s, --stack TEXT       Dependency stack
  -v, --version TEXT     Language version
  -e, --extras TEXT      Comma-separated extra dependencies
  -d, --directory PATH   Target directory (default: current directory)
  --help                 Show this message and exit.

How It Works

1. Select language, stack, and version (interactively or via flags)
2. The CLI calls the StackForDev API, or generates locally with --local
3. A tailored Dockerfile (and optionally docker-compose.yml + .dockerignore) is returned
4. Build the image and run commands inside the container — no local language installation needed

Architecture

Request flow:

CLI / API call
  → API Gateway (rate-limited, CORS)
  → AWS Lambda (Python 3.11, container runtime, ECR)
  → Pydantic validation + injection checks
  → Template substitution (language + stack + version)
  → S3 dedup check → upload
  → JSON response {dockerfile, key, message}

Infrastructure: AWS Lambda + API Gateway + S3 + ECR, provisioned with Terraform. CloudWatch alarms monitor error rate and throttles. S3 lifecycle policy manages storage costs automatically.

Monitoring

• Errors alarm: fires when Lambda errors ≥ 5 in a 5-minute window → SNS notification
• Throttles alarm: fires when Lambda throttles ≥ 10 in a 5-minute window
• Log retention: CloudWatch Logs retained for 30 days, structured as JSON for Logs Insights queries
• Concurrency cap: Lambda reserved concurrency set to 10 to prevent runaway scaling

Contributing

See CONTRIBUTING.md for local setup, how to run tests, and how to add a new language template in 4 steps.

Changelog

See CHANGELOG.md.

License

MIT — see LICENSE for details.