Packages Overview

VentureKit is a single monorepo of 14 packages — 10 free under the @venturekit scope and 4 commercial under @venturekit-pro. 13 are published to npm today; @venturekit/testing is not yet published (see its page). Install only what you need.

Installation

Published packages are public on npm — the same npm install works for free and pro packages alike (the one exception, @venturekit/testing, is not yet published). 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.
@venturekit/notify — Transactional notifications (email/WhatsApp/SMS/push) with a Postgres outbox + cron dispatcher.
@venturekit/testing — Integration & E2E test harness — launch the local stack, seed cognito-local auth, reset the DB, drive a typed API client. Dev-only. Not yet published to npm.

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/chat — Real-time chat — rooms, messages, presence, read receipts.
@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.

The full commercial license text ships in the packages/pro/LICENSE file of the VentureKit monorepo.

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/notify        ← Transactional notifications (email/WhatsApp/SMS/push)
├── @venturekit-pro/ai        ← AI — embeddings, RAG, agents
├── @venturekit-pro/billing   ← Plans, usage, feature gating
├── @venturekit-pro/chat      ← Real-time chat — rooms, messages, presence
└── @venturekit-pro/tenancy   ← Multi-tenancy

@venturekit/testing sits outside this tree: it’s a dev-only test harness with no @venturekit/core dependency. Its only peers are optional — @venturekit/data (for the truncate* DB helpers) and @aws-sdk/client-cognito-identity-provider (for minting JWTs).

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 tracks the stabilization builds (the default latest tag may be slightly newer)
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