Vovk.ts
A Next.js back-end framework that turns typed procedures into endpoints, MCP tools, typed clients and OpenAPI docs.
At a Glance
Vovk.ts core framework released under the MIT License, free to use, modify and distribute.
Engagement
Available On
Alternatives
Listed Nov 2026
About Vovk.ts
Vovk.ts is an open-source framework by Andrey Gubanov that adds an API layer on top of Next.js App Router Route Handlers. Its unit is the procedure, a typed function with its schema, from which it derives the HTTP endpoint, a local call, typed clients, an OpenAPI document and an AI tool. It requires Node.js 24.15+ (or Bun 1.4+, Deno 2.9+), Next.js 15+ and TypeScript 5.5+.
What It Is
Vovk.ts is a TypeScript back-end framework native to Next.js. You define a procedure with validation for params, query, body and output, then add decorators to serve it over HTTP or expose it as an LLM tool. Controllers and services follow a NestJS-style layout without a DI container, modules or a custom server. Validation works with libraries that implement Standard Schema, such as Zod, Valibot and ArkType.
What One Procedure Becomes
From a single definition, Vovk.ts derives:
- a Next.js Route Handler
- a local
.fn()call for SSR, server components and server actions - a generated fetch-based typed RPC client
- an OpenAPI 3.x document
- an AI tool with name, description, inputSchema and execute, produced by
deriveTools - a generated README documenting the client library
Clients can also be generated and packaged for Python and Rust, and third-party OpenAPI schemas can be imported as modules with the same call shape (OpenAPI mixins). Procedures can stream JSON Lines through async generators.
Agent Skills and Setup
The project ships 15 topic skills that teach coding agents such as Claude Code, Cursor, Windsurf, GitHub Copilot and Cline how to build with Vovk.ts, installable with npx skills add finom/vovk or as a Claude Code plugin. Alternatively, npx vovk-cli@latest init sets up an existing Next.js project. Documented examples include Hello World, a multitenant app routing subdomains to segments, and a Realtime Kanban app with AI chat, MCP and Telegram integration.
Community Discussions
Be the first to start a conversation about Vovk.ts
Share your experience with Vovk.ts, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
Vovk.ts core framework released under the MIT License, free to use, modify and distribute.
- MIT License
- Next.js API layer with procedures
- MCP tools derived from procedures
- Typed TypeScript, Python and Rust clients
- OpenAPI 3.x generation
Capabilities
Key Features
- Procedures that derive HTTP endpoints, local .fn() calls, typed clients and OpenAPI docs
- AI tool derivation with deriveTools for MCP and LLM function calling
- Generated TypeScript, Python and Rust client libraries
- JSON Lines streaming via async generators
- OpenAPI mixins for third-party APIs
- Segments compiled into separate serverless functions
- Multitenancy via subdomain routing
- Validation through Standard Schema libraries (Zod, Valibot, ArkType)
- 15 agent skills for coding agents
- Runs on Node.js, Bun or Deno without a custom server
