CloudDev v0.7.0

This release adds 6 new AWS services — bringing CloudDev to 43 emulated services across 53 modules. v0.7.0 closes the biggest remaining gaps with LocalStack: compute infrastructure, managed data services, and developer tooling.

---

🆕 What's New

EC2 — Elastic Compute Cloud (port 4600)

Instance lifecycle, AMIs, key pairs, and security groups via the EC2 Query API.

RDS — Relational Database Service (port 4601)

DB instance lifecycle, snapshots, and parameter groups. Supports PostgreSQL and MySQL engine types.

OpenSearch (port 4602)

Domain management, tags, and search endpoint emulation for local Elasticsearch/OpenSearch development.

MSK — Managed Streaming for Kafka (port 4603)

Kafka cluster management with broker endpoint emulation. Returns realistic bootstrap broker strings for local streaming apps.

CodePipeline (port 4604)

Full pipeline lifecycle — create, start, stop, and track executions. Uses the native X-Amz-Target JSON protocol.

WAF — Web Application Firewall (port 4605)

Web ACL and rule group management with resource association support. Compatible with API Gateway and CloudFront resources.

---

📦 All Services (v0.7.0)

43 AWS services across 53 modules — see the README for the full port reference.

---

🔄 Upgrade

git pull origin main
go build -o clouddev .

---

Built for Devs · Apache 2.0

CloudDev v0.6.0

This release adds 8 new AWS services, bringing CloudDev to 37 total services — making it a credible LocalStack replacement for real-world applications.

✨ New Services

Service	Port
Kinesis Data Streams	4568
Kinesis Firehose	4571
ECS (Elastic Container Service)	4561
ECR (Elastic Container Registry)	4562
CloudFront	4563
AppSync	4567
Athena	4564
ACM (Certificate Manager)	4560

📦 Install

git clone https://github.com/Jeffrin-dev/CloudDev.git
cd CloudDev
go build -o clouddev .

📊 Stats

• 47 modules total
• 37 AWS services
• Single Go binary, zero dependencies

Built with Claude (Instructor) · Codex (Developer)

Developer experience & modern AWS patterns — 6 new services, 29 total.

🆕 New Services

Service	Port	Description
CloudWatch Events	4590	Event rules, scheduling, targets, custom events
SES	4579	Send emails, verify identities, quota & statistics
DynamoDB Streams	4570	Stream table changes, shards, iterators, records
Lambda Function URLs	4595	Direct HTTPS endpoints for Lambda functions
API Gateway v2	4573	HTTP APIs with routes, integrations, and stages
Bedrock	4591	Mock LLM inference — Claude, Titan, Llama

---

🔧 Improvements

• DynamoDB UpdateItem — SET expression support added
• DynamoDB → Streams integration — creating a table with StreamEnabled=true automatically registers a stream
• AWS CLI v2 compatible — all services tested with AWS CLI v2

---

📊 Cumulative Stats

• 39 modules built across 5 versions
• 29 AWS services emulated
• 30 test suites passing
• Single Go binary, zero runtime dependencies

---

🚀 Quick Start

git clone https://github.com/Jeffrin-dev/CloudDev.git
cd CloudDev
go build -o clouddev .
./clouddev init my-app
cd my-app
../clouddev up

---

Built for Devs

CloudDev v0.4.0 - added CloudWatch Metrics,X-Ray and 4 more

CloudDev v0.4.0 — Observability, Compute & Infrastructure

We're excited to release CloudDev v0.4.0! This release adds 7 new AWS services bringing the total to 23 emulated services and 33 modules. v0.4.0 focuses on observability, advanced compute features, and filling the most-requested infrastructure gaps.

---

🆕 What's New

Phase 1 — Observability

CloudWatch Metrics (port 4582)

Full metrics collection, statistics, and alarms.

• PutMetricData — store metric data points with MetricData.member.N.* format
• GetMetricStatistics — returns Sum, Average, Minimum, Maximum, SampleCount
• ListMetrics — with optional Namespace filter
• PutMetricAlarm — store alarm definitions, initial state OK
• DescribeAlarms, DeleteAlarms

X-Ray (port 4588)

Distributed tracing and service graph emulation.

• PutTraceSegments — parse and store trace segments
• GetTraceSummaries — aggregated summaries with fault/error flags
• BatchGetTraces — fetch full traces by ID
• GetServiceGraph — auto-built from stored service names
• PutTelemetryRecords — ack/no-op

Phase 2 — Compute

SQS FIFO Queues (port 4576)

FIFO support added to the existing SQS emulator.

• .fifo suffix detection at queue creation
• MessageGroupId enforcement
• 5-minute MessageDeduplicationId deduplication window
• GetQueueAttributes returns FifoQueue=true
• Ordered delivery per message group

Lambda Layers (port 4578)

Full layer version management.

• PublishLayerVersion — auto-incrementing versions
• ListLayers — always shows latest version
• ListLayerVersions, GetLayerVersion, DeleteLayerVersion
• Compatible runtimes stored and returned

Phase 3 — Infrastructure

Route53 (port 4589)

Hosted zone and DNS record management.

• CreateHostedZone, ListHostedZones, GetHostedZone, DeleteHostedZone
• ChangeResourceRecordSets — CREATE, UPSERT, DELETE actions
• ListResourceRecordSets
• Zone IDs formatted as /hostedzone/Z{id}

SSM Parameter Store (port 4583)

Full parameter lifecycle management.

• PutParameter — version auto-increment on overwrite
• GetParameter, GetParameters, GetParametersByPath (prefix match)
• DeleteParameter, DescribeParameters (metadata only)
• Types: String, StringList, SecureString

Rekognition (port 4594)

Mock computer vision responses.

• DetectLabels — Person 99.1, Outdoors 87.3, Nature 76.5
• DetectFaces — BoundingBox + Confidence 99.5
• DetectText — "Hello World" LINE 98.2
• CompareFaces — Similarity 95.5
• IndexFaces — UUID generated FaceId
• SearchFacesByImage — Similarity 92.3

---

🖥️ Dashboard Upgrade

The web dashboard at localhost:4580 has been upgraded from a table layout to a card-based layout showing all 23 services. Each card displays service name, port, and a 🟢/🔴 status indicator. Auto-refreshes every 5 seconds.

---

🐛 Bug Fixes & Protocol Fixes

• Fixed CloudWatch Metrics to use form-encoded Action dispatch (not JSON X-Amz-Target)
• Fixed Lambda Layers API prefix from /2018-11-14 to /2018-10-31
• Fixed SQS FIFO queue URL format consistency

---

📊 v0.4.0 Stats

Metric	Value
Total services	23
New services in v0.4.0	6 new + 1 extended (SQS FIFO)
Total modules	33
New modules in v0.4.0	7
Test coverage	All services

---

🔄 Upgrading from v0.3.0

git pull origin main
go build -o clouddev .
go test ./...

No breaking changes — all existing ports and APIs remain the same.

---

🛣️ What's Next (v0.5.0)

• CloudWatch Events
• SES email emulation
• DynamoDB Streams
• Lambda function URLs
• API Gateway v2 (HTTP API)
• Bedrock (mock LLM responses)

---

🙏 Acknowledgements

Thank you to everyone who starred ⭐, forked, and filed issues. We've crossed 10 stars and growing!

Full Changelog: https://github.com/Jeffrin-dev/CloudDev/compare/v0.3.0...v0.4.0

CloudDev v0.3.0 — 17 AWS Services, Zero Dependencies

CloudDev v0.3.0 — Enterprise AWS Services

We're excited to release CloudDev v0.3.0, the biggest update yet. This release adds 8 new AWS services, bringing the total to 17 emulated services. v0.3.0 focuses on enterprise-grade AWS services required by most production applications — auth, security, orchestration, events, and caching.

---

🆕 What's New

Phase 1 — Auth & Security

IAM (port 4593)

Full IAM emulation with users, roles, and policies.

• CreateUser, DeleteUser, ListUsers
• CreateRole, DeleteRole, ListRoles
• CreatePolicy, AttachRolePolicy, DetachRolePolicy
• AssumeRole — returns temporary credentials

STS (port 4592)

Security Token Service for temporary credentials.

• GetCallerIdentity
• AssumeRole
• GetSessionToken

KMS (port 4599)

Key Management Service for encryption/decryption.

• CreateKey, ListKeys, DescribeKey
• Encrypt, Decrypt — full roundtrip support
• GenerateDataKey — random 32-byte key generation
• ScheduleKeyDeletion
• Full AWS CLI v2 compatibility (double-encoded ciphertext handling)

Phase 2 — Orchestration

CloudFormation (port 4581)

Stack management with template parsing.

• CreateStack, UpdateStack, DeleteStack
• ListStacks, DescribeStacks, DescribeStackResources
• Parses YAML and JSON templates
• Maps AWS resource types to CloudDev services

Step Functions (port 4585)

State machine definitions and execution management.

• CreateStateMachine, DeleteStateMachine, ListStateMachines, DescribeStateMachine
• StartExecution, StopExecution, ListExecutions, DescribeExecution
• Executions automatically transition RUNNING → SUCCEEDED

Phase 3 — Events & Cache

EventBridge (port 4587)

Event bus, rules, and target routing.

• CreateEventBus, ListEventBuses
• PutRule, ListRules, DeleteRule
• PutTargets, PutEvents
• Routes matched events to Lambda and SQS targets

ElastiCache (Redis port 4598, HTTP port 4597)

Redis-compatible local cache + cluster management API.

Redis commands supported: PING, SET, GET, DEL, EXISTS, EXPIRE, TTL, KEYS, FLUSHALL, QUIT

HTTP management API:

• CreateCacheCluster, DeleteCacheCluster, DescribeCacheClusters

Cognito (port 4596)

User pools and authentication.

• CreateUserPool, DeleteUserPool, ListUserPools, DescribeUserPool
• CreateUserPoolClient, ListUserPoolClients
• AdminCreateUser, AdminDeleteUser, ListUsers
• InitiateAuth, RespondToAuthChallenge
• Returns mock tokens for any username/password

---

🖥️ Dashboard Upgrade

The web dashboard at localhost:4580 now shows all 17 services with real-time green/red status indicators and auto-refreshes every 5 seconds.

---

🐛 Bug Fixes

• Fixed KMS double-encoded ciphertext handling for AWS CLI v2 compatibility
• Fixed Step Functions X-Amz-Target prefix (AWSStepFunctions.*)
• Fixed EventBridge X-Amz-Target prefix (AWSEvents.*)
• Fixed ElastiCache HTTP API to use form-encoded requests instead of JSON
• Fixed ElastiCache DescribeCacheClusters empty response bug

---

📊 v0.3.0 Stats

Metric	Value
Total services	17
New services in v0.3.0	8
Total modules	26
New modules in v0.3.0	8
Test coverage	All services

---

🔄 Upgrading from v0.2.0

git pull origin main
go build -o clouddev .
go test ./...

No breaking changes — all existing ports and APIs remain the same.

---

🛣️ What's Next (v0.4.0)

• CloudWatch Metrics
• SQS FIFO queues
• Lambda layers
• X-Ray tracing
• Cognito hosted UI

---

🙏 Acknowledgements

Built using Claude (Instructor) + Codex (Developer). Thanks to everyone who starred, forked, and filed issues — you're what keeps this project moving forward!

Full Changelog: https://github.com/Jeffrin-dev/CloudDev/compare/v0.2.0...v0.3.0

CloudDev v0.2.0

🎉 CloudDev v0.2.0

Building on v0.1.0 — 8 new modules added, bringing the total to 18.

✨ What's New in v0.2.0

New Services

• 📣 SNS — pub/sub topics with SQS delivery (port 4575)
• 🔐 Secrets Manager — local secret storage (port 4584)
• 📊 CloudWatch Logs — log groups, streams and events (port 4586)

New Features

• ⚡ Lambda Hot Reload — drop a .zip into functions/ and it auto-loads within 2 seconds
• 📋 Status Command — clouddev status shows live service health
• 💾 Data Persistence — S3 and DynamoDB data survives restarts
• 💰 Cost Estimator — clouddev estimate shows how much you save vs real AWS
• ☸️ Kubernetes Support — clouddev detect now parses Kubernetes manifests

📦 All 18 Modules

Module	Description
1	CLI Skeleton
2	Config Parser
3	Docker Manager
4	S3 Emulation
5	DynamoDB Emulation
6	Lambda Emulation
7	SQS Emulation
8	API Gateway
9	Web Dashboard
10	IaC Parser
11	Lambda Hot Reload
12	Status Command
13	Data Persistence
14	SNS Emulation
15	Secrets Manager
16	CloudWatch Logs
17	Cost Estimator
18	Kubernetes Support

🚀 Quick Start

clouddev init my-app
cd my-app
clouddev up

💰 How Much Does CloudDev Save You?

clouddev estimate

CloudDev Cost Estimator

Service	Estimated Monthly Cost
S3	$5.00
DynamoDB	$10.00
Lambda	$3.00
SQS	$2.00
API Gateway	$8.00
Total	$28.00

💰 Running locally with CloudDev saves you ~$28.00/month!

Why CloudDev?

LocalStack recently closed its free Community Edition.
CloudDev is the free, open alternative — no account required,
no paywalls, forever.

CloudDev v0.1.0 — Initial Release

## 🎉 CloudDev v0.1.0

First release of CloudDev — a lightweight, 100% open-source 
local AWS development environment.

### What's included
- ☁️ S3 emulation (port 4566)
- 🗄️ DynamoDB emulation (port 4569)
- ⚡ Lambda emulation with hot reload (port 4574)
- 📨 SQS emulation (port 4576)
- 🌐 API Gateway with Lambda forwarding (port 4572)
- 🖥️ Web dashboard (port 4580)
- 🔍 IaC auto-detection (Terraform + CloudFormation)

### Why CloudDev?
LocalStack recently closed its open-source Community Edition.
CloudDev is the free, open alternative — no account required,
no paywalls, forever.