feat: add aws-ministack component (#15)

* feat: add aws-ministack component

Add MiniStack as a free, open-source LocalStack alternative.
MiniStack supports 30+ AWS services on a single port (4567) with
no account, license key, or telemetry required.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: mark LocalStack as legacy, add MiniStack comparison

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: diogocasteluber

.env.dist

@@ -1,4 +1,5 @@
 AWS_PORT=4566
+AWS_MINISTACK_PORT=4567
 
 KAFKA_PORT=9092
 KAFKA_UI_PORT=8037

README.md

@@ -20,7 +20,8 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/opencodeco/stack/main/in
 | `stack postgres` | PostgreSQL & pgAdmin (http://localhost:8034) |
 | `stack kafka` | Kafka and UI for Apache Kafka (http://localhost:8037) |
 | `stack rabbitmq` | RabbitMQ & Management Plugin (http://localhost:8038) |
-| `stack aws` | AWS services via LocalStack (http://localhost:4566) |
+| `stack aws` | AWS services via LocalStack _(legacy, [see details below](#aws-localstack-vs-ministack))_ (http://localhost:4566) |
+| `stack aws-ministack` | AWS services via MiniStack (http://localhost:4567) |
 | `stack hyperdx` | HyperDX local (http://localhost:8080) | 
 | `stack o11y` | OpenTelemetry Collector, Jaeger UI, Prometheus & Grafana (see below) |
 
@@ -94,4 +95,17 @@ stack mysql logs -f
 
 ---
 
+### AWS: LocalStack vs MiniStack
+
+| | `stack aws` (LocalStack) | `stack aws-ministack` (MiniStack) |
+| --- | --- | --- |
+| Free | ⚠️ Core services behind paid plan | ✅ Free forever (MIT) |
+| Account / API key | Required | Not required |
+| Telemetry | Yes | No |
+| Services | 30+ (many paid) | 30+ |
+
+> **`stack aws` (LocalStack) is considered legacy.** LocalStack moved most of its core services behind a paid subscription. `stack aws-ministack` using [MiniStack](https://ministack.org/) is the recommended free alternative — it is a drop-in replacement compatible with any AWS CLI or SDK tool via `--endpoint-url=http://localhost:4567`.
+
+---
+
 ⚠️ **Remember:** this is suited for development environments only.

aws-ministack/docker-compose.yml

@@ -0,0 +1,11 @@
+services:
+  opencodeco-aws-ministack:
+    container_name: opencodeco-aws-ministack
+    image: nahuelnucera/ministack:1.1.61
+    ports:
+      - ${AWS_MINISTACK_PORT}:4566
+
+networks:
+  default:
+    name: opencodeco
+    external: true

stack

@@ -22,6 +22,7 @@ if [ $# -eq 0 ] || [ "help" = "${1}" ]; then
     echo "  kafka    Kafka and UI for Apache Kafka (http://localhost:${KAFKA_UI_PORT})"
     echo "  rabbitmq RabbitMQ & Management Plugin  (http://localhost:${RABBITMQ_UI_PORT})"
     echo "  aws      AWS services via LocalStack   (http://localhost:${AWS_PORT})"
+    echo "  aws-ministack AWS services via MiniStack  (http://localhost:${AWS_MINISTACK_PORT})"
     echo "  hyperdx  HyperDX local.                (http://localhost:${HYPERDX_APP_PORT})"
     echo "  o11y     OTel Collectors, Jaeger UI, Prometheus & Grafana"
     echo ""