vk deploy

Usage

vk deploy [options]

Options

Option	Description	Default
-s, --stage <stage>	Stage name (dev, stage, prod)	dev

Description

Deploys your VentureKit application to AWS via CDK. The stage determines which environment config is used:

Stage	Config File	Typical Preset
dev	config/dev.ts	nano
stage	config/stage.ts	micro
prod	config/prod.ts	medium or large

Examples

# Deploy dev (default)
vk deploy

# Deploy staging
vk deploy --stage stage

# Deploy production
vk deploy --stage prod

Production Warning

When deploying to prod or production, the CLI displays a warning:

⚠️  Production deployment - please verify your changes

Outputs

After a successful deployment, the CLI shows:

• The deployed stage name
• The API Gateway URL (if available)

✅ Deployed to prod
API URL: https://abc123.execute-api.eu-west-1.amazonaws.com

Under the Hood

1. Loads your vk.config.ts and resolves the environment config for the stage
2. Generates a CDK app in .vk/cdk/ with a VentureStack
3. Runs cdk deploy to synthesize and deploy CloudFormation stacks
4. Creates or updates Lambda functions, API Gateway, and all declared infrastructure