stackport 0.4.2__tar.gz → 0.4.4__tar.gz

{stackport-0.4.2/stackport.egg-info → stackport-0.4.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.4.2
+Version: 0.4.4
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
 Project-URL: Homepage, https://github.com/DaviReisVieira/stackport
 Project-URL: Repository, https://github.com/DaviReisVieira/stackport
 Project-URL: Issues, https://github.com/DaviReisVieira/stackport/issues
-Keywords: aws,ministack,localstack,browser,devtools,emulator
+Keywords: aws,ministack,floci,localstack,browser,devtools,emulator
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: FastAPI
 Classifier: Intended Audience :: Developers
@@ -75,15 +75,18 @@ Dynamic: license-file
 - **CLI** — `stackport status`, `list`, `describe`, `export` with JSON/CSV/table output
 - **Real-time dashboard** with WebSocket-powered live updates
 - **Keyboard shortcuts** — 16 shortcuts for fast navigation (press `?` to view)
-- Single Docker image, works with MiniStack, LocalStack, Moto, or any AWS-compatible endpoint
+- Single Docker image, works with [MiniStack](https://github.com/ministackorg/ministack), [Floci](https://github.com/floci-io/floci), LocalStack, Moto, or any AWS-compatible endpoint
 
 ## Quick Start
 
-### With a local emulator (recommended)
+### With a local emulator
+
+Start whichever emulator you use, then point StackPort at it:
 
 ```bash
-# Start MiniStack (or LocalStack, Moto, etc.)
-pip install ministack && ministack
+# Start an emulator on :4566 (pick one)
+docker run -d -p 4566:4566 ministackorg/ministack   # MiniStack
+docker run -d -p 4566:4566 floci/floci              # Floci
 
 # Start StackPort
 pip install stackport
@@ -108,16 +111,32 @@ You can also configure per-endpoint authentication from the Settings UI — sele
 
 When connected to real AWS, StackPort shows a warning banner and operates in read-only mode unless writes are explicitly enabled.
 
-### Docker Compose (MiniStack + StackPort)
+### Docker Compose
+
+Each example runs the emulator, StackPort, and a one-shot `seed` container that creates a few resources (S3, SQS, SNS, DynamoDB, Secrets Manager, IAM, Logs, Step Functions) so the dashboard has something to show on first load. Both use the same seed. Swap in LocalStack, Moto, or any AWS-compatible endpoint by replacing the emulator service and updating `AWS_ENDPOINT_URL`.
 
-This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+**MiniStack + StackPort** — [`examples/docker-compose.yml`](examples/docker-compose.yml)
 
 ```bash
 curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
+# If the dashboard is empty: docker compose logs seed
 ```
 
+[MiniStack](https://github.com/ministackorg/ministack) derives the URLs it returns (SQS queue URLs, pre-signed URLs) from the request `Host`, so they resolve from other containers and from the host without extra configuration.
+
+**Floci + StackPort** — [`examples/docker-compose.floci.yml`](examples/docker-compose.floci.yml)
+
+```bash
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.floci.yml
+docker compose -f docker-compose.floci.yml up -d
+# Open http://localhost:8080
+# If the dashboard is empty: docker compose -f docker-compose.floci.yml logs seed
+```
+
+[Floci](https://github.com/floci-io/floci) takes the hostname for the URLs it returns from `FLOCI_HOSTNAME`, which the example sets to `floci` so they resolve from other containers. From the host, reach the same resources through `http://localhost:4566`.
+
 ### Docker (standalone)
 
 ```bash
@@ -351,6 +370,10 @@ ui/src/
   lib/             API client, types, service icons, utils
 ```
 
+## Origin
+
+StackPort started as a web UI pull request to [MiniStack](https://github.com/ministackorg/ministack) ([ministack#116](https://github.com/ministackorg/ministack/pull/116)). The MiniStack maintainers suggested it would be more useful as a standalone tool that talks to any emulator over the standard AWS API, and that is what it became. Thanks to [@Nahuel990](https://github.com/Nahuel990) and [@McDoit](https://github.com/McDoit) for pushing it in that direction.
+
 ## Contributors
 
 <a href="https://github.com/DaviReisVieira/stackport/graphs/contributors">

{stackport-0.4.2 → stackport-0.4.4}/README.md

@@ -39,15 +39,18 @@
 - **CLI** — `stackport status`, `list`, `describe`, `export` with JSON/CSV/table output
 - **Real-time dashboard** with WebSocket-powered live updates
 - **Keyboard shortcuts** — 16 shortcuts for fast navigation (press `?` to view)
-- Single Docker image, works with MiniStack, LocalStack, Moto, or any AWS-compatible endpoint
+- Single Docker image, works with [MiniStack](https://github.com/ministackorg/ministack), [Floci](https://github.com/floci-io/floci), LocalStack, Moto, or any AWS-compatible endpoint
 
 ## Quick Start
 
-### With a local emulator (recommended)
+### With a local emulator
+
+Start whichever emulator you use, then point StackPort at it:
 
 ```bash
-# Start MiniStack (or LocalStack, Moto, etc.)
-pip install ministack && ministack
+# Start an emulator on :4566 (pick one)
+docker run -d -p 4566:4566 ministackorg/ministack   # MiniStack
+docker run -d -p 4566:4566 floci/floci              # Floci
 
 # Start StackPort
 pip install stackport
@@ -72,16 +75,32 @@ You can also configure per-endpoint authentication from the Settings UI — sele
 
 When connected to real AWS, StackPort shows a warning banner and operates in read-only mode unless writes are explicitly enabled.
 
-### Docker Compose (MiniStack + StackPort)
+### Docker Compose
+
+Each example runs the emulator, StackPort, and a one-shot `seed` container that creates a few resources (S3, SQS, SNS, DynamoDB, Secrets Manager, IAM, Logs, Step Functions) so the dashboard has something to show on first load. Both use the same seed. Swap in LocalStack, Moto, or any AWS-compatible endpoint by replacing the emulator service and updating `AWS_ENDPOINT_URL`.
 
-This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+**MiniStack + StackPort** — [`examples/docker-compose.yml`](examples/docker-compose.yml)
 
 ```bash
 curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
+# If the dashboard is empty: docker compose logs seed
 ```
 
+[MiniStack](https://github.com/ministackorg/ministack) derives the URLs it returns (SQS queue URLs, pre-signed URLs) from the request `Host`, so they resolve from other containers and from the host without extra configuration.
+
+**Floci + StackPort** — [`examples/docker-compose.floci.yml`](examples/docker-compose.floci.yml)
+
+```bash
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.floci.yml
+docker compose -f docker-compose.floci.yml up -d
+# Open http://localhost:8080
+# If the dashboard is empty: docker compose -f docker-compose.floci.yml logs seed
+```
+
+[Floci](https://github.com/floci-io/floci) takes the hostname for the URLs it returns from `FLOCI_HOSTNAME`, which the example sets to `floci` so they resolve from other containers. From the host, reach the same resources through `http://localhost:4566`.
+
 ### Docker (standalone)
 
 ```bash
@@ -315,6 +334,10 @@ ui/src/
   lib/             API client, types, service icons, utils
 ```
 
+## Origin
+
+StackPort started as a web UI pull request to [MiniStack](https://github.com/ministackorg/ministack) ([ministack#116](https://github.com/ministackorg/ministack/pull/116)). The MiniStack maintainers suggested it would be more useful as a standalone tool that talks to any emulator over the standard AWS API, and that is what it became. Thanks to [@Nahuel990](https://github.com/Nahuel990) and [@McDoit](https://github.com/McDoit) for pushing it in that direction.
+
 ## Contributors
 
 <a href="https://github.com/DaviReisVieira/stackport/graphs/contributors">

{stackport-0.4.2 → stackport-0.4.4}/backend/cli.py

@@ -10,13 +10,37 @@ import click
 import uvicorn
 
 from backend.aws_client import get_client
-from backend.config import AWS_ENDPOINT_URL, AWS_REGION, LOG_LEVEL, STACKPORT_PORT, STACKPORT_SERVICES
-from backend.routes.resources import DESCRIBE_REGISTRY, _extract_id, _serialize
+from backend.config import (
+    AWS_ENDPOINT_URL,
+    AWS_REGION,
+    LOG_LEVEL,
+    STACKPORT_PORT,
+    STACKPORT_SERVICES,
+    endpoint_store,
+)
+from backend.routes.resources import (
+    DESCRIBE_REGISTRY,
+    _PREFERRED_ID_FIELD,
+    _extract_id,
+    _serialize,
+)
 from backend.routes.stats import SERVICE_REGISTRY, _METHOD_KWARGS, _count_items, _probe_service
 
 logger = logging.getLogger(__name__)
 
 
+def _client_kwargs(endpoint: str | None, region: str | None) -> dict:
+    """Resolve where a CLI command talks to.
+
+    An explicit --endpoint (or AWS_ENDPOINT_URL at startup) wins. Without one,
+    fall back to the saved default endpoint, the same one the web UI uses.
+    Passing the result to get_client explicitly is what makes the flag work
+    once ~/.stackport/endpoints.json exists.
+    """
+    url = endpoint if endpoint is not None else endpoint_store.get_default_url()
+    return {"endpoint_url": url, "region": region}
+
+
 @click.group(invoke_without_command=True)
 @click.version_option(package_name="stackport")
 @click.pass_context
@@ -39,22 +63,14 @@ def serve(port):
 @click.option("--output", type=click.Choice(["json", "table"]), default="table", help="Output format")
 def status(endpoint, region, output):
     """Show all services with availability and resource counts."""
-    # Override endpoint/region if provided
-    if endpoint != AWS_ENDPOINT_URL:
-        import os
-
-        os.environ["AWS_ENDPOINT_URL"] = endpoint
-    if region != AWS_REGION:
-        import os
-
-        os.environ["AWS_REGION"] = region
+    client_kwargs = _client_kwargs(endpoint, region)
 
     enabled_services = [s.strip() for s in STACKPORT_SERVICES.split(",") if s.strip()]
     services = {}
 
     try:
         with ThreadPoolExecutor(max_workers=min(len(enabled_services), 10)) as executor:
-            futures = {executor.submit(_probe_service, svc): svc for svc in enabled_services}
+            futures = {executor.submit(_probe_service, svc, **client_kwargs): svc for svc in enabled_services}
             for future in as_completed(futures):
                 svc_name, result = future.result()
                 services[svc_name] = result
@@ -89,15 +105,7 @@ def status(endpoint, region, output):
 @click.option("--output", type=click.Choice(["json", "table", "csv"]), default="table", help="Output format")
 def list(service, endpoint, region, output):
     """List resources for a service."""
-    # Override endpoint/region if provided
-    if endpoint != AWS_ENDPOINT_URL:
-        import os
-
-        os.environ["AWS_ENDPOINT_URL"] = endpoint
-    if region != AWS_REGION:
-        import os
-
-        os.environ["AWS_REGION"] = region
+    client_kwargs = _client_kwargs(endpoint, region)
 
     registry_entries = SERVICE_REGISTRY.get(service)
     if not registry_entries:
@@ -109,7 +117,7 @@ def list(service, endpoint, region, output):
     resources = {}
     for resource_type, boto3_service, method_name, response_key in registry_entries:
         try:
-            client = get_client(boto3_service)
+            client = get_client(boto3_service, **client_kwargs)
             method = getattr(client, method_name)
             kwargs = _METHOD_KWARGS.get((boto3_service, method_name), {})
             resp = method(**kwargs)
@@ -129,8 +137,9 @@ def list(service, endpoint, region, output):
         writer = csv.writer(sys.stdout)
         writer.writerow(["service", "resource_type", "resource_id", "name"])
         for resource_type, items in resources.items():
+            preferred = _PREFERRED_ID_FIELD.get((service, resource_type))
             for item in items:
-                resource_id = _extract_id(item)
+                resource_id = _extract_id(item, preferred)
                 name = item.get("Name", item.get("FunctionName", item.get("TableName", resource_id))) if isinstance(item, dict) else resource_id
                 writer.writerow([service, resource_type, resource_id, name])
     else:
@@ -139,8 +148,9 @@ def list(service, endpoint, region, output):
             if items:
                 click.echo(f"\n{resource_type.upper()} ({len(items)}):")
                 click.echo("-" * 60)
+                preferred = _PREFERRED_ID_FIELD.get((service, resource_type))
                 for item in items[:20]:  # Limit to first 20 for readability
-                    resource_id = _extract_id(item)
+                    resource_id = _extract_id(item, preferred)
                     if isinstance(item, dict):
                         name = item.get("Name", item.get("FunctionName", item.get("TableName", "")))
                         if name and name != resource_id:
@@ -164,20 +174,12 @@ def list(service, endpoint, region, output):
 @click.option("--output", type=click.Choice(["json", "table"]), default="json", help="Output format")
 def describe(service, resource_type, resource_id, endpoint, region, output):
     """Describe a specific resource."""
-    # Override endpoint/region if provided
-    if endpoint != AWS_ENDPOINT_URL:
-        import os
-
-        os.environ["AWS_ENDPOINT_URL"] = endpoint
-    if region != AWS_REGION:
-        import os
-
-        os.environ["AWS_REGION"] = region
+    client_kwargs = _client_kwargs(endpoint, region)
 
     # Special case for WAFv2
     if (service, resource_type) == ("wafv2", "web_acls"):
         try:
-            client = get_client("wafv2")
+            client = get_client("wafv2", **client_kwargs)
             acls = client.list_web_acls(Scope="REGIONAL").get("WebACLs", [])
             match = next((a for a in acls if a.get("Name") == resource_id), None)
             if not match:
@@ -211,7 +213,7 @@ def describe(service, resource_type, resource_id, endpoint, region, output):
         }
 
         try:
-            client = get_client(boto3_service)
+            client = get_client(boto3_service, **client_kwargs)
             method = getattr(client, method_name)
             if id_param in _LIST_PARAMS:
                 resp = method(**{id_param: [resource_id]})

{stackport-0.4.2 → stackport-0.4.4}/backend/routes/dynamodb.py

@@ -1,4 +1,5 @@
 import base64
+import binascii
 import json
 import logging
 from typing import Any
@@ -27,6 +28,58 @@ def _plain_to_dynamodb_item(plain: dict[str, Any]) -> dict[str, Any]:
     return {k: _serializer.serialize(v) for k, v in plain.items()}
 
 
+# Binary (B / BS) travels as base64 over StackPort's HTTP API, the same way AWS
+# writes it in DynamoDB JSON. boto3 hands us raw bytes, which JSON cannot carry.
+
+
+def _to_json_safe(obj: Any) -> Any:
+    """Replace every bytes value with its base64 text. Safe to apply to whole
+    low-level responses: DynamoDB only returns bytes inside B and BS."""
+    if isinstance(obj, (bytes, bytearray)):
+        return base64.b64encode(obj).decode("ascii")
+    if isinstance(obj, dict):
+        return {k: _to_json_safe(v) for k, v in obj.items()}
+    if isinstance(obj, list):
+        return [_to_json_safe(v) for v in obj]
+    return obj
+
+
+def _b64_to_bytes(value: Any, name: str) -> bytes:
+    if isinstance(value, (bytes, bytearray)):
+        return bytes(value)
+    try:
+        return base64.b64decode(value, validate=True)
+    except (binascii.Error, TypeError, ValueError) as e:
+        raise HTTPException(status_code=400, detail=f"Attribute {name!r} is not valid base64 for type B") from e
+
+
+def _attr_from_json(av: Any, name: str) -> Any:
+    """Inverse of _to_json_safe for one DynamoDB attribute value. Type-aware, so
+    strings under S stay strings and only B / BS are decoded."""
+    if not isinstance(av, dict):
+        return av
+    if "B" in av:
+        return {**av, "B": _b64_to_bytes(av["B"], name)}
+    if "BS" in av and isinstance(av["BS"], list):
+        return {**av, "BS": [_b64_to_bytes(v, name) for v in av["BS"]]}
+    if "L" in av and isinstance(av["L"], list):
+        return {**av, "L": [_attr_from_json(v, name) for v in av["L"]]}
+    if "M" in av and isinstance(av["M"], dict):
+        return {**av, "M": {k: _attr_from_json(v, f"{name}.{k}") for k, v in av["M"].items()}}
+    return av
+
+
+def _item_from_json(item: dict[str, Any]) -> dict[str, Any]:
+    return {k: _attr_from_json(v, k) for k, v in item.items()}
+
+
+def _key_value(attr_type: str, value: str, name: str) -> dict[str, Any]:
+    """Typed key value for a query condition. Binary keys arrive as base64."""
+    if attr_type == "B":
+        return {"B": _b64_to_bytes(value, name)}
+    return {attr_type: value}
+
+
 def _get_partition_sort_keys(dynamodb: Any, table_name: str) -> tuple[str | None, str | None]:
     table_resp = dynamodb.describe_table(TableName=table_name)
     key_schema = table_resp["Table"].get("KeySchema", [])
@@ -56,7 +109,7 @@ def _coerce_item_dict(raw: dict[str, Any], item_format: str) -> dict[str, Any]:
             return _plain_to_dynamodb_item(raw)
         except TypeError as e:
             raise HTTPException(status_code=400, detail=f"Could not convert plain item to DynamoDB types: {e}") from e
-    return raw
+    return _item_from_json(raw)
 
 
 def _coerce_key_dict(raw: dict[str, Any], item_format: str) -> dict[str, Any]:
@@ -65,7 +118,7 @@ def _coerce_key_dict(raw: dict[str, Any], item_format: str) -> dict[str, Any]:
             return _plain_to_dynamodb_item(raw)
         except TypeError as e:
             raise HTTPException(status_code=400, detail=f"Could not convert plain key to DynamoDB types: {e}") from e
-    return raw
+    return _item_from_json(raw)
 
 
 def _invalidate_table_item_count(table_name: str, endpoint_url: str | None) -> None:
@@ -237,7 +290,7 @@ def scan_table(
     if exclusive_start_key:
         try:
             decoded = base64.b64decode(exclusive_start_key).decode("utf-8")
-            scan_params["ExclusiveStartKey"] = json.loads(decoded)
+            scan_params["ExclusiveStartKey"] = _item_from_json(json.loads(decoded))
         except Exception:
             logger.debug("Invalid exclusive_start_key", exc_info=True)
 
@@ -248,11 +301,11 @@ def scan_table(
         last_evaluated_key = resp.get("LastEvaluatedKey")
         next_token = None
         if last_evaluated_key:
-            next_token = base64.b64encode(json.dumps(last_evaluated_key).encode("utf-8")).decode("utf-8")
+            next_token = base64.b64encode(json.dumps(_to_json_safe(last_evaluated_key)).encode("utf-8")).decode("utf-8")
 
         return {
             "table": name,
-            "items": items,
+            "items": _to_json_safe(items),
             "count": len(items),
             "scanned_count": resp.get("ScannedCount", len(items)),
             "next_token": next_token,
@@ -285,19 +338,19 @@ def query_table(name: str, request: QueryRequest, ep: EndpointInfo = Depends(get
         # Build key condition expression
         key_condition = f"#{partition_key} = :pk"
         expression_attr_names = {f"#{partition_key}": partition_key}
-        expression_attr_values = {":pk": {partition_key_type: request.partition_key_value}}
+        expression_attr_values = {":pk": _key_value(partition_key_type, request.partition_key_value, partition_key)}
 
         if sort_key and request.sort_key_value:
             sort_key_type = attribute_defs.get(sort_key, "S")
             if request.sort_key_operator == "=":
                 key_condition += f" AND #{sort_key} = :sk"
-                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+                expression_attr_values[":sk"] = _key_value(sort_key_type, request.sort_key_value, sort_key)
             elif request.sort_key_operator in ("<", "<=", ">", ">="):
                 key_condition += f" AND #{sort_key} {request.sort_key_operator} :sk"
-                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+                expression_attr_values[":sk"] = _key_value(sort_key_type, request.sort_key_value, sort_key)
             elif request.sort_key_operator == "BEGINS_WITH":
                 key_condition += f" AND begins_with(#{sort_key}, :sk)"
-                expression_attr_values[":sk"] = {sort_key_type: request.sort_key_value}
+                expression_attr_values[":sk"] = _key_value(sort_key_type, request.sort_key_value, sort_key)
             expression_attr_names[f"#{sort_key}"] = sort_key
 
         query_params = {
@@ -313,10 +366,12 @@ def query_table(name: str, request: QueryRequest, ep: EndpointInfo = Depends(get
 
         return {
             "table": name,
-            "items": items,
+            "items": _to_json_safe(items),
             "count": len(items),
             "scanned_count": resp.get("ScannedCount", len(items)),
         }
+    except HTTPException:
+        raise
     except Exception as e:
         logger.error("Failed to query table %s: %s", name, e, exc_info=True)
         return {"error": str(e), "items": [], "count": 0}
@@ -411,7 +466,7 @@ def batch_write_items(
         return {
             "ok": True,
             "table": name,
-            "unprocessed": uproc,
+            "unprocessed": _to_json_safe(uproc),
             "message": "Some items were not processed; retry with returned keys.",
         }
 

{stackport-0.4.2 → stackport-0.4.4}/backend/routes/resources.py

@@ -84,6 +84,12 @@ _PREFERRED_ID_FIELD: dict[tuple[str, str], str] = {
     ("elasticmapreduce", "clusters"): "Id",
     ("cognito-idp", "user_pools"): "Id",
     ("apigateway", "rest_apis"): "id",
+    ("apigateway", "apis"): "ApiId",
+    ("iam", "policies"): "Arn",
+    ("ec2", "subnets"): "SubnetId",
+    ("ec2", "security_groups"): "GroupId",
+    ("elasticfilesystem", "file_systems"): "FileSystemId",
+    ("rds", "db_clusters"): "DBClusterIdentifier",
 }
 
 # Known ID field names for extracting a resource identifier from list results

{stackport-0.4.2 → stackport-0.4.4}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "stackport"
-version = "0.4.2"
+version = "0.4.4"
 description = "Universal AWS resource browser for local emulators"
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
 authors = [{name = "Davi Reis Vieira"}]
-keywords = ["aws", "ministack", "localstack", "browser", "devtools", "emulator"]
+keywords = ["aws", "ministack", "floci", "localstack", "browser", "devtools", "emulator"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Framework :: FastAPI",

{stackport-0.4.2 → stackport-0.4.4/stackport.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: stackport
-Version: 0.4.2
+Version: 0.4.4
 Summary: Universal AWS resource browser for local emulators
 Author: Davi Reis Vieira
 License: MIT
 Project-URL: Homepage, https://github.com/DaviReisVieira/stackport
 Project-URL: Repository, https://github.com/DaviReisVieira/stackport
 Project-URL: Issues, https://github.com/DaviReisVieira/stackport/issues
-Keywords: aws,ministack,localstack,browser,devtools,emulator
+Keywords: aws,ministack,floci,localstack,browser,devtools,emulator
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: FastAPI
 Classifier: Intended Audience :: Developers
@@ -75,15 +75,18 @@ Dynamic: license-file
 - **CLI** — `stackport status`, `list`, `describe`, `export` with JSON/CSV/table output
 - **Real-time dashboard** with WebSocket-powered live updates
 - **Keyboard shortcuts** — 16 shortcuts for fast navigation (press `?` to view)
-- Single Docker image, works with MiniStack, LocalStack, Moto, or any AWS-compatible endpoint
+- Single Docker image, works with [MiniStack](https://github.com/ministackorg/ministack), [Floci](https://github.com/floci-io/floci), LocalStack, Moto, or any AWS-compatible endpoint
 
 ## Quick Start
 
-### With a local emulator (recommended)
+### With a local emulator
+
+Start whichever emulator you use, then point StackPort at it:
 
 ```bash
-# Start MiniStack (or LocalStack, Moto, etc.)
-pip install ministack && ministack
+# Start an emulator on :4566 (pick one)
+docker run -d -p 4566:4566 ministackorg/ministack   # MiniStack
+docker run -d -p 4566:4566 floci/floci              # Floci
 
 # Start StackPort
 pip install stackport
@@ -108,16 +111,32 @@ You can also configure per-endpoint authentication from the Settings UI — sele
 
 When connected to real AWS, StackPort shows a warning banner and operates in read-only mode unless writes are explicitly enabled.
 
-### Docker Compose (MiniStack + StackPort)
+### Docker Compose
+
+Each example runs the emulator, StackPort, and a one-shot `seed` container that creates a few resources (S3, SQS, SNS, DynamoDB, Secrets Manager, IAM, Logs, Step Functions) so the dashboard has something to show on first load. Both use the same seed. Swap in LocalStack, Moto, or any AWS-compatible endpoint by replacing the emulator service and updating `AWS_ENDPOINT_URL`.
 
-This example uses [MiniStack](https://github.com/Nahuel990/ministack) as the emulator, but you can swap it for LocalStack, Moto, or any AWS-compatible endpoint — just update `AWS_ENDPOINT_URL`.
+**MiniStack + StackPort** — [`examples/docker-compose.yml`](examples/docker-compose.yml)
 
 ```bash
 curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.yml
 docker compose up -d
 # Open http://localhost:8080
+# If the dashboard is empty: docker compose logs seed
 ```
 
+[MiniStack](https://github.com/ministackorg/ministack) derives the URLs it returns (SQS queue URLs, pre-signed URLs) from the request `Host`, so they resolve from other containers and from the host without extra configuration.
+
+**Floci + StackPort** — [`examples/docker-compose.floci.yml`](examples/docker-compose.floci.yml)
+
+```bash
+curl -O https://raw.githubusercontent.com/DaviReisVieira/stackport/main/examples/docker-compose.floci.yml
+docker compose -f docker-compose.floci.yml up -d
+# Open http://localhost:8080
+# If the dashboard is empty: docker compose -f docker-compose.floci.yml logs seed
+```
+
+[Floci](https://github.com/floci-io/floci) takes the hostname for the URLs it returns from `FLOCI_HOSTNAME`, which the example sets to `floci` so they resolve from other containers. From the host, reach the same resources through `http://localhost:4566`.
+
 ### Docker (standalone)
 
 ```bash
@@ -351,6 +370,10 @@ ui/src/
   lib/             API client, types, service icons, utils
 ```
 
+## Origin
+
+StackPort started as a web UI pull request to [MiniStack](https://github.com/ministackorg/ministack) ([ministack#116](https://github.com/ministackorg/ministack/pull/116)). The MiniStack maintainers suggested it would be more useful as a standalone tool that talks to any emulator over the standard AWS API, and that is what it became. Thanks to [@Nahuel990](https://github.com/Nahuel990) and [@McDoit](https://github.com/McDoit) for pushing it in that direction.
+
 ## Contributors
 
 <a href="https://github.com/DaviReisVieira/stackport/graphs/contributors">

{stackport-0.4.2 → stackport-0.4.4}/stackport.egg-info/SOURCES.txt

@@ -15,27 +15,27 @@ backend/../ui/dist/favicon.png
 backend/../ui/dist/favicon.svg
 backend/../ui/dist/index.html
 backend/../ui/dist/stackport-logo.svg
-backend/../ui/dist/assets/CloudscapeAbout-DccVyQFu.js
-backend/../ui/dist/assets/CloudscapeDashboard-DtV4-eQq.js
-backend/../ui/dist/assets/CloudscapeLearn-DW6RZAj4.js
+backend/../ui/dist/assets/CloudscapeAbout-BRbsDskR.js
+backend/../ui/dist/assets/CloudscapeDashboard-j2f4Elz2.js
+backend/../ui/dist/assets/CloudscapeLearn-CVW3k3X0.js
+backend/../ui/dist/assets/CloudscapeResourceBrowser-CgWdgn20.js
 backend/../ui/dist/assets/CloudscapeResourceBrowser-CzwePG-V.css
-backend/../ui/dist/assets/CloudscapeResourceBrowser-FpsXtjf_.js
-backend/../ui/dist/assets/CloudscapeSettings-UdgiI6dm.js
+backend/../ui/dist/assets/CloudscapeSettings-CIXFvPKv.js
 backend/../ui/dist/assets/CloudscapeShell-BXHVWjDE.css
-backend/../ui/dist/assets/CloudscapeShell-Be6uFzsz.js
-backend/../ui/dist/assets/StateMachineGraph-G76o42iO.js
-backend/../ui/dist/assets/index-B33aGwWE.js
-backend/../ui/dist/assets/index-B3bka_BF.js
-backend/../ui/dist/assets/index-B3zGVRXf.js
-backend/../ui/dist/assets/index-CNWD72L_.js
+backend/../ui/dist/assets/CloudscapeShell-DNfhSg0O.js
+backend/../ui/dist/assets/StateMachineGraph-DvF_kIOO.js
+backend/../ui/dist/assets/index-BC7E-Fm4.js
+backend/../ui/dist/assets/index-BLdRlH9d.js
+backend/../ui/dist/assets/index-Ba-oOcd3.js
+backend/../ui/dist/assets/index-BkSgVQ0X.js
+backend/../ui/dist/assets/index-C5z3cir-.js
 backend/../ui/dist/assets/index-DE--A2EE.css
 backend/../ui/dist/assets/index-DKIdXFX0.css
 backend/../ui/dist/assets/index-DNBdeKId.css
-backend/../ui/dist/assets/index-DhD1oh4N.js
 backend/../ui/dist/assets/index-DoY0HscW.css
 backend/../ui/dist/assets/index-DrkkXAoG.css
+backend/../ui/dist/assets/index-Dw6TGweb.js
 backend/../ui/dist/assets/index-Vf0UFiCT.css
-backend/../ui/dist/assets/index-hhBdqMqs.js
 backend/../ui/dist/assets/stepfunctions-graph-B6nvU4OB.js
 backend/../ui/dist/assets/utils-Cfmwk2UT.js
 backend/../ui/dist/aws-icons/acm.svg
@@ -148,27 +148,27 @@ ui/dist/favicon.png
 ui/dist/favicon.svg
 ui/dist/index.html
 ui/dist/stackport-logo.svg
-ui/dist/assets/CloudscapeAbout-DccVyQFu.js
-ui/dist/assets/CloudscapeDashboard-DtV4-eQq.js
-ui/dist/assets/CloudscapeLearn-DW6RZAj4.js
+ui/dist/assets/CloudscapeAbout-BRbsDskR.js
+ui/dist/assets/CloudscapeDashboard-j2f4Elz2.js
+ui/dist/assets/CloudscapeLearn-CVW3k3X0.js
+ui/dist/assets/CloudscapeResourceBrowser-CgWdgn20.js
 ui/dist/assets/CloudscapeResourceBrowser-CzwePG-V.css
-ui/dist/assets/CloudscapeResourceBrowser-FpsXtjf_.js
-ui/dist/assets/CloudscapeSettings-UdgiI6dm.js
+ui/dist/assets/CloudscapeSettings-CIXFvPKv.js
 ui/dist/assets/CloudscapeShell-BXHVWjDE.css
-ui/dist/assets/CloudscapeShell-Be6uFzsz.js
-ui/dist/assets/StateMachineGraph-G76o42iO.js
-ui/dist/assets/index-B33aGwWE.js
-ui/dist/assets/index-B3bka_BF.js
-ui/dist/assets/index-B3zGVRXf.js
-ui/dist/assets/index-CNWD72L_.js
+ui/dist/assets/CloudscapeShell-DNfhSg0O.js
+ui/dist/assets/StateMachineGraph-DvF_kIOO.js
+ui/dist/assets/index-BC7E-Fm4.js
+ui/dist/assets/index-BLdRlH9d.js
+ui/dist/assets/index-Ba-oOcd3.js
+ui/dist/assets/index-BkSgVQ0X.js
+ui/dist/assets/index-C5z3cir-.js
 ui/dist/assets/index-DE--A2EE.css
 ui/dist/assets/index-DKIdXFX0.css
 ui/dist/assets/index-DNBdeKId.css
-ui/dist/assets/index-DhD1oh4N.js
 ui/dist/assets/index-DoY0HscW.css
 ui/dist/assets/index-DrkkXAoG.css
+ui/dist/assets/index-Dw6TGweb.js
 ui/dist/assets/index-Vf0UFiCT.css
-ui/dist/assets/index-hhBdqMqs.js
 ui/dist/assets/stepfunctions-graph-B6nvU4OB.js
 ui/dist/assets/utils-Cfmwk2UT.js
 ui/dist/aws-icons/acm.svg