MiniStack Simplifies Local AWS Step Functions with Generic SDK Dispatcher

How we made Step Functions call any AWS service locally

MiniStack has introduced a generic dispatcher for the Step Functions aws-sdk integration pattern. This system allows local workflows to call 38 different AWS services without requiring unique handlers for each service.

Why This Matters

Local AWS emulators typically require hardcoded handlers for every service integration, leading to significant gaps when developers need to test newer services or specific API actions. By implementing a generic dispatcher that parses ARNs and routes requests to existing service handlers, MiniStack eliminates the need for Lambda wrappers and provides a high-fidelity local environment that mirrors the direct service integration recommended by AWS.

Key Insights

• MiniStack supports 38 AWS services and 48 CloudFormation resource types through a single port for local development in 2026.
• The generic dispatcher enables direct aws-sdk:* task routing for JSON-protocol services including DynamoDB, SecretsManager, and ECS.
• The system maintains compatibility with major infrastructure tools, supporting Terraform VPC module v6.6.0 and CDK bootstrap operations.
• MiniStack utilizes real infrastructure backends, such as Postgres for RDS and Redis for ElastiCache, to ensure local execution mirrors production behavior.
• The dispatcher automates protocol-specific tasks like X-Amz-Target header construction and PascalCase key conversion for service compatibility.

Working Examples

Example of a Step Functions state machine using the direct aws-sdk integration pattern.

{
"Type": "Task",
"Resource": "arn:aws:states:::aws-sdk:dynamodb:PutItem",
"Parameters": {
"TableName": "my-table",
"Item": { "pk": { "S.$": "$.id" } }
}
}

Python snippet to run a Step Functions workflow against the local MiniStack endpoint.

import boto3
sfn = boto3.client("stepfunctions",
endpoint_url="http://localhost:4566",
region_name="us-east-1",
aws_access_key_id="test",
aws_secret_access_key="test")
sfn.create_state_machine(
name="my-workflow",
definition='...your ASL with aws-sdk integrations...',
roleArn="arn:aws:iam::000000000000:role/role",
)

Practical Applications

• Development teams can test complex AWS Step Functions workflows locally without the latency or cost of cloud-based testing environments.
• Engineering teams can use MiniStack to validate Terraform VPC module v6.6.0 configurations locally before deployment to production.
• A common anti-pattern is using Lambda wrappers for service calls in Step Functions; MiniStack allows developers to use direct integrations, reducing architectural complexity.
• Hardcoded service handlers in traditional emulators often lack support for SecretsManager or KMS; MiniStack’s generic dispatcher resolves this by routing to existing internal handlers.

References:

• https://dev.to/nahuel990/how-we-made-step-functions-call-any-aws-service-locally-2m44