Introduction

What is VentureKit?

VentureKit is a modular TypeScript framework for building SaaS applications on AWS. It gives founders and developers full control without the boilerplate — from Lambda handlers to infrastructure provisioning, authentication, billing, and AI.

Why VentureKit?

Building a SaaS product on AWS requires stitching together dozens of services: Lambda, API Gateway, Cognito, RDS, S3, SQS, ElastiCache, and more. Each service has its own SDK, configuration format, and deployment quirks.

VentureKit abstracts this complexity behind a declarative, type-safe API:

One config file defines your entire application
File-based routing discovers your API endpoints automatically
Infrastructure intents let you declare what you need, not how to build it
Presets give you production-ready defaults in one word (nano, micro, medium, large)
Unified handler adapts to context — public or authenticated, with automatic status codes

Design Principles

Explicit over implicit — Every config field is visible and overridable. No hidden magic.
- Presets as shortcuts — Use nano, micro, medium, large to get started. Override what you need.
- Layered config — Base (identity) + Security (auth) + Environment (resources) = Full control.
- Smart defaults — Handlers adapt to context. No scopes = public. With scopes = authenticated.

Framework at a Glance

vk.config.ts     ← Defines your entire app
config/
  base.ts                ← Project identity (never changes)
  security.ts            ← OAuth scopes and clients
  dev.ts / prod.ts       ← Environment-specific sizing
src/routes/
  health/get.ts          ← GET /health (public)
  tasks/post.ts          ← POST /tasks (authenticated)
  tasks/[id]/get.ts      ← GET /tasks/{id} (dynamic)

Packages

VentureKit is a modular monorepo with 10 independent packages:

Package	Purpose
`@venturekit/core`	Types, presets, config resolution, validation
`@venturekit/runtime`	Handlers, context, middleware, logging, errors
`@venturekit/infra`	CDK constructs for AWS infrastructure
`@venturekit/cli`	CLI — scaffolding, dev, deploy, generate, migrate
`@venturekit/auth`	Cognito, RBAC, scope checking, JWT utilities
`@venturekit/data`	RDS config, migrations, query utilities, transactions
`@venturekit/storage`	S3 config, CDN, lifecycle policies
`@venturekit-pro/tenancy`	Multi-tenant resolution, isolation, quotas
`@venturekit-pro/ai`	Embeddings, vector stores, RAG, agents
`@venturekit-pro/billing`	Plans, feature limits, invoicing

Install only the packages you need. All packages are published under the @venturekit scope on npm.

Next Steps

Quickstart — Create your first VentureKit project in under 5 minutes.
- Architecture — Understand how VentureKit packages fit together.
- Configuration — Learn the layered configuration system.
- CLI Reference — Explore all CLI commands.