Packages Overview

VentureKit ships 8 free npm packages under the @venturekit scope and 4 commercial packages under the @venturekit-pro scope. All 12 packages are published from a single monorepo. Install only what you need.

Installation

All packages are public on npm — the same npm install works for free and pro packages alike. During the stabilization phase, use the dev dist-tag:

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

# Pro (also public install — production use requires a license key, see below)
npm install @venturekit-pro/ai@dev

No .npmrc configuration or registry authentication is needed for installation. Pro packages enforce licensing at runtime, not at install time — see Pro License below.

Package Map

Free (`@venturekit/*`, Apache-2.0)

@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, pure-SQL migrations, query utilities, transactions.
@venturekit/storage — S3 config, CDN support, lifecycle policies.
@venturekit/integrations — HTTP client, OAuth2, API key management for third-party APIs.

Pro (`@venturekit-pro/*`, Commercial)

@venturekit-pro/ai — Embeddings, vector stores, RAG pipelines, agents.
@venturekit-pro/billing — Plan definitions, feature limits, usage tracking, invoicing.
@venturekit-pro/comms — Email, SMS, push, chat, broadcast messaging.
@venturekit-pro/tenancy — Tenant resolution, context, data isolation, quota enforcement.

Pro License

Pro packages are free to install and use locally for development, evaluation, and testing. Production use requires an active VentureKit Pro subscription and a license key.

# .env (production)
VENTUREKIT_LICENSE_KEY=vk_live_...

The SDK validates the key on boot, caches the result, and fails open in development with a console warning. Get a key at venturekit.dev/pricing.

See the packages/pro/LICENSE file in the repository for the full commercial license text.

Dependency Graph

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

@venturekit/core              ← Foundation (every package depends 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/integrations  ← Third-party API integrations
├── @venturekit-pro/ai        ← AI — embeddings, RAG, agents
├── @venturekit-pro/billing   ← Plans, usage, feature gating
├── @venturekit-pro/comms     ← Email, SMS, push, chat
└── @venturekit-pro/tenancy   ← Multi-tenancy

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 the Updating section below for details.

Updating

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

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