Question 1

How to integrate custom AWS resources not in Punchcard?

Accepted Answer

You can use raw CDK constructs alongside Punchcard, but this breaks type safety and requires manual IAM and client setup. It's feasible for edge cases but undermines the framework's core benefits.

Question 2

Punchcard vs AWS CDK alone for TypeScript?

Accepted Answer

Punchcard adds a higher-level, type-safe abstraction layer on top of CDK, unifying runtime and infrastructure code. CDK alone offers more flexibility but requires manual type definitions and separate runtime logic.

Question 3

Does Punchcard support AWS Step Functions or EventBridge?

Accepted Answer

No, the README and examples only cover services like DynamoDB, SNS, SQS, Kinesis, and Glue. For Step Functions or EventBridge, you'd need to use CDK directly, losing Punchcard's type-safe integrations.

Question 4

How to test Punchcard apps locally without deploying?

Accepted Answer

Punchcard relies on CDK synthesis, so local testing involves mocking AWS services or using tools like AWS SAM Local. The framework lacks built-in mocking or local simulation features.

Question 5

Can I use Punchcard with existing DynamoDB tables not created by CDK?

Accepted Answer

Yes, via CDK's import methods, but you'll need to manually define Shapes to match the table schema, and type safety may be limited if schemas aren't perfectly aligned.

Question 6

What's the performance overhead of Punchcard's stream processing?

Accepted Answer

The abstractions compile to standard AWS SDK calls, so runtime overhead is minimal. However, the type-safe DSL and chaining add compile-time checks without impacting execution speed significantly.

punchcard

What is punchcard?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions