Packages Overview - Contract Kit

Core Packages

@contract-kit/core

Contract definitions and builders - the foundation of Contract Kit

@contract-kit/server

Framework-agnostic server runtime with validation and middleware

@contract-kit/client

Typed HTTP client generated from your contracts

contract-kit

Meta package that re-exports core, client, application, ports, errors, config, and OpenAPI helpers

Server Adapters

@contract-kit/next

Next.js adapter for App Router and Pages Router

Express Adapter

Coming soon - Express.js integration

Fastify Adapter

Coming soon - Fastify integration

Hono Adapter

Coming soon - Hono integration

Architecture Packages

@contract-kit/application

Use cases layer with commands and queries

@contract-kit/ports

Dependency injection with ports and providers

@contract-kit/domain

Domain entities and value objects helpers

@contract-kit/errors

Common error types and utilities

React Packages

@contract-kit/react

Base React utilities and hooks

@contract-kit/react-query

TanStack Query integration for data fetching

@contract-kit/react-hook-form

React Hook Form integration for forms

Provider Packages

Database

@contract-kit/provider-drizzle-turso

Drizzle ORM with Turso database

Caching

@contract-kit/provider-redis

Redis caching with ioredis

Email

@contract-kit/provider-mail-resend

Email with Resend

@contract-kit/provider-mail-smtp

Email with SMTP

Authentication

@contract-kit/provider-auth-better-auth

Authentication with Better Auth

Background Jobs

@contract-kit/provider-inngest

Background jobs with Inngest

Rate Limiting

@contract-kit/provider-rate-limit-upstash

Rate limiting with Upstash

Logging

@contract-kit/provider-logger-pino

Structured logging with Pino

Utilities

@contract-kit/openapi

Generate OpenAPI 3.1 specifications

@contract-kit/devtools

Development tools and debugging utilities

Installation Patterns

Minimal Setup

For a basic API with no database or providers:

npm install contract-kit zod
npm install @contract-kit/next next

Full Stack Setup

For a complete application with React and providers:

# Core
npm install contract-kit zod

# Server adapter
npm install @contract-kit/next next

# React integration
npm install @contract-kit/react-query @tanstack/react-query
npm install @contract-kit/react-hook-form react-hook-form

# Providers (choose what you need)
npm install @contract-kit/provider-drizzle-turso
npm install @contract-kit/provider-redis ioredis
npm install @contract-kit/provider-mail-resend resend
npm install @contract-kit/provider-auth-better-auth better-auth

Package Compatibility

Package	Next.js 14	Next.js 15	React 18	React 19
@contract-kit/core	✅	✅	-	-
@contract-kit/next	✅	✅	-	-
@contract-kit/react	-	-	✅	✅
@contract-kit/react-query	-	-	✅	✅

Get Started

Core Concepts

Packages

React Integration

Providers

​Core Packages

@contract-kit/core

@contract-kit/server

@contract-kit/client

contract-kit

​Server Adapters

@contract-kit/next

Express Adapter

Fastify Adapter

Hono Adapter

​Architecture Packages

@contract-kit/application

@contract-kit/ports

@contract-kit/domain

@contract-kit/errors

​React Packages

@contract-kit/react

@contract-kit/react-query

@contract-kit/react-hook-form

​Provider Packages

​Database

@contract-kit/provider-drizzle-turso

​Caching

@contract-kit/provider-redis

​Email

@contract-kit/provider-mail-resend

@contract-kit/provider-mail-smtp

​Authentication

@contract-kit/provider-auth-better-auth

​Background Jobs

@contract-kit/provider-inngest

​Rate Limiting

@contract-kit/provider-rate-limit-upstash

​Logging

@contract-kit/provider-logger-pino

​Utilities