Packages Overview

VentureKit is published as 10 independent npm packages under the @venturekit scope. Install only the packages you need.

Installation

All packages are public on npm. During the stabilization phase, use the dev dist-tag:

npm install @venturekit/core@dev @venturekit/runtime@dev @venturekit/infra@dev

No .npmrc configuration or authentication is needed.

Package Map

• @venturekit/core — Types, presets, config resolution, validation. The foundation every other package depends on.
  • @venturekit/runtime — Handlers, context, middleware, logging, errors, WebSocket connection store.
  • @venturekit/infra — defineVenture(), CDK constructs, file-based route discovery, infrastructure translation.
  • @venturekit/cli — vk CLI — init, dev, deploy, remove, generate, migrate.
  • @venturekit/auth — Cognito config, RBAC, scope checking, JWT utilities.
  • @venturekit/data — RDS config, Drizzle migrations, query utilities, transactions.
  • @venturekit/storage — S3 config, CDN support, lifecycle policies.
  • @venturekit-pro/tenancy — Tenant resolution, context, data isolation, quota enforcement.
  • @venturekit-pro/ai — Embeddings, vector stores, RAG pipelines, agents.
  • @venturekit-pro/billing — Plan definitions, feature limits, invoicing.

Dependency Graph

All packages depend on @venturekit/core. Feature packages are independent of each other.

@venturekit/core          ← Foundation (all packages depend on this)
├── @venturekit/runtime   ← Application runtime
├── @venturekit/infra     ← Infrastructure (+ aws-cdk-lib)
├── @venturekit/cli       ← Developer CLI
├── @venturekit/auth      ← Authentication
├── @venturekit/data      ← Database (+ pg)
├── @venturekit/storage   ← Storage
├── @venturekit-pro/tenancy   ← Multi-tenancy
├── @venturekit-pro/ai        ← AI (+ openai, bedrock, pinecone)
└── @venturekit-pro/billing   ← Billing (invoicing, plans, feature gating)

Minimum Project

A minimal VentureKit project needs three packages:

npm install @venturekit/core@dev @venturekit/runtime@dev @venturekit/infra@dev

Add feature packages as you need them.

Versioning

During the stabilization phase, packages use timestamped dev versions:

0.0.0-dev.20260306101400

• The dev dist-tag always points to the latest build
• Breaking changes are expected
• Pin to a specific version if you need stability

See Consuming VentureKit Packages for details.

Updating

# Update all VentureKit packages
pnpm update "@venturekit/*@dev"

# Or with npm
npm install @venturekit/core@dev @venturekit/runtime@dev