outcropLambda-first AWS CDK constructs with preview stacks per pull request

Opinionated constructs, an account baseline, runtime helpers, a CLI and reusable GitHub Actions workflows. Open source, MIT licensed.

Get started

Constructs

GitHub

Preview stack per pull request

Every PR deploys an isolated copy of the service under its own hostname and is destroyed on close. Ticket id or PR number becomes the preview id.

Account baseline

GitHub OIDC deploy roles, DNS and certificates, alert topics, event bus, KMS, budgets, security services and shared configuration published under /platform in SSM.

Sensible defaults

Every construct ships with naming, encryption, retention, removal policies, alarms and dashboards wired to the environment. cdk-nag clean out of the box.

Runtime helpers

A small runtime package with structured logging, config and secrets access, an event envelope and handler wrappers for HTTP, SQS and EventBridge.

Reusable workflows

Checks, preview deploy and destroy, promotion through dev, stage and prod, and account baseline deploys as workflow_call workflows pinned to a floating v1 tag.

CLI and agent skills

npx @rpallas/outcrop-cli create service scaffolds infra, handlers, tests, workflows and docs. Bundled skills teach coding agents the conventions.

Packages

Package	Purpose
`@rpallas/outcrop`	Constructs, naming, SSM contract, alarms, `PlatformApp` and `PlatformStack`
`@rpallas/outcrop-account`	Account baseline modules, `createAccountBaseline`, StackSets
`@rpallas/outcrop-runtime`	Lambda runtime helpers and the Powertools layer
`@rpallas/outcrop-cli`	`create service`, `create account`, `preview-id`, `stack-outputs`, skills
`@rpallas/outcrop-neon`	Neon Postgres branch per preview
`@rpallas/outcrop-chatops`	Alarm notifications to Slack and Microsoft Teams

npx @rpallas/outcrop-cli create service orders --http-api --dynamodb