A local development companion for cloud-native apps. Iterate fast without cloud bills, then land cleanly on your target CSP.
Modern cloud development is expensive and slow to iterate on: every test hits a billed service, every feature branch needs its own sandbox, and every new joiner waits for cloud credentials. DevCloud runs a local, API-compatible cloud environment so you can:
- Develop offline — no VPN, no credentials, no internet
- Iterate without a bill — run integration tests at CI speed, not cloud speed
- Onboard in minutes —
docker runand your team is productive - Ship with confidence — compatibility tests against real SDKs mean your code that works locally works in production
DevCloud is an on-ramp to the cloud, not a replacement for it. The goal is to make the local → CSP transition boring.
Today DevCloud targets AWS. Our long-term goal is to support the full range of Cloud Service Providers (Azure, GCP, and beyond) behind the same local runtime and plugin architecture. We are rolling this out in phases — see docs/roadmap.md for the phased plan.
- 104 AWS services across all major categories (run
make statsfor current counts; see services-matrix.md) - boto3-compatible — a 729-test compatibility suite runs in CI (
make test-compat); works with most boto3 apps, and unsupported operations return a clean AWS error, never a false success - Cross-service integration — CFN provisioning, DDB Streams → Lambda, EventBridge targets, S3 → Lambda
- Smithy-driven codegen — auto-generate Go interfaces, types, and serializers from Smithy models
- Weekly auto-sync — GitHub Actions keeps generated code up to date with upstream AWS API changes
- Single binary, zero-config — one Docker image, one port (4747), no config file required (embedded defaults)
- Environment variable overrides —
DEVCLOUD_SERVICES,DEVCLOUD_DATA_DIR,DEVCLOUD_PORTfor quick configuration without YAML - SDK/CLI compatible — works with the AWS SDK, CLI, Terraform, CDK out of the box
- Admin API — opt-in REST + WebSocket at
/devcloud/api/*for service status, resource listing, and live request logs (admin.enabled: true). The web dashboard UI lives in a separate repository.
docker run -p 4747:4747 ghcr.io/skyoo2003/devcloud:latestThen point any AWS SDK at http://localhost:4747. See Getting Started for boto3 / AWS CLI / Terraform examples and installation options.
| Service | Protocol | Storage | Docs |
|---|---|---|---|
| S3 | REST-XML | Filesystem + SQLite | docs/services/s3.md |
| SQS | Query + JSON | In-memory | docs/services/sqs.md |
| DynamoDB | JSON 1.0 | BadgerDB | docs/services/dynamodb.md |
| Lambda | REST-JSON | SQLite + Filesystem | docs/services/lambda.md |
| IAM/STS | Query | SQLite | docs/services/iam-sts.md |
Azure and GCP support is on the roadmap.
Start at the docs index for the full map. Quick links:
- Getting Started — Installation, first use, boto3 / AWS CLI / Terraform examples
- Configuration — Config options, env-var overrides, tier shortcuts
- Architecture — System design, codegen pipeline, plugin model, multi-CSP vision
- Services Matrix — services, coverage status, boto3 compatibility
- Plugin API — the stable
ServicePlugincontract and v1.x stability policy - Roadmap — Phased plan toward multi-CSP support
- FAQ / Troubleshooting — Common questions and errors
- Contributing — Development setup, adding new services
- Support / Governance — Where to ask, how decisions are made
- Changelog — Release history
We welcome contributions — especially service implementations, compatibility fixes, and documentation. See the Contributing Guide for development setup and the Code of Conduct for community standards.
For security issues, please follow the Security Policy and do not file a public issue.
Licensed under the Apache License, Version 2.0. See NOTICE for attribution requirements.
DevCloud is an independent open-source project. References to cloud service providers describe API compatibility only. All trademarks (AWS, Azure, Google Cloud, etc.) are the property of their respective owners. See TRADEMARKS.md for details.