Skip to main content
The VK-IO ecosystem includes a variety of official and community-maintained packages that extend the library’s functionality.

​
Official Packages

These packages are maintained by the VK-IO core team:

@vk-io/authorization

User authorization by login & password, implicit flow, and more

@vk-io/session

Simple implementation of sessions for stateful bots

@vk-io/scenes

Middleware-based scene management for conversation flows

@vk-io/streaming

Receive real-time data with VK Streaming API

@vk-io/hear

Pattern matching for text messages (hear handlers)

@vk-io/stateless-prompt

Stateless prompt implementation for asking questions

​
Community Packages

​
User Interaction

Repository: fakemancat/vk-io-questionSimple promise-based prompt for asking users questions and waiting for responses.
import { QuestionManager } from 'vk-io-question';

const questionManager = new QuestionManager();

const answer = await questionManager.ask({
    userId: context.senderId,
    question: 'What is your name?'
});
Repository: MrZillaGold/vk-io-pagesDynamic pagination module for creating paginated menus and lists with keyboard navigation.Perfect for:
  • Displaying long lists across multiple pages
  • Creating navigable catalogs
  • Building interactive menus with navigation buttons

​
Bot Frameworks

Repository: u14-team/hentaA simple and lightweight VK bot engine built on top of VK-IO.Features:
  • Easy-to-use command system
  • Built-in middleware support
  • Simplified bot development workflow

​
Storage & State Management

Repository: xtcry/vk-io-redis-storageRedis storage adapter for @vk-io/session.
import { SessionManager } from '@vk-io/session';
import { RedisStorage } from 'vk-io-redis-storage';

const sessionManager = new SessionManager({
    storage: new RedisStorage({
        host: 'localhost',
        port: 6379
    })
});
Perfect for production environments where you need persistent session storage across bot restarts.

​
Framework Integrations

Repository: xtcry/nestjs-vkNestJS module for integrating VK-IO with NestJS framework.Features:
  • Dependency injection for VK-IO instances
  • Decorator-based update handlers
  • Seamless integration with NestJS ecosystem
import { VkModule } from 'nestjs-vk';

@Module({
    imports: [
        VkModule.forRoot({
            token: process.env.VK_TOKEN
        })
    ]
})
export class AppModule {}

​
Installation

All packages can be installed using your preferred package manager: 
npm install <package-name>

​
Contributing Your Module

Built something useful for the VK-IO community? We’d love to feature it here!
1

Ensure quality

Make sure your package:
  • Has clear documentation
  • Includes TypeScript typings
  • Is published on npm
  • Has a public GitHub repository
2

Submit a request

Create a new issue on the VK-IO repository with:
  • Package name and npm link
  • GitHub repository link
  • Brief description of functionality
  • Example usage code
3

Get listed

Once reviewed, your package will be added to this page

​
Package Guidelines

When building packages for VK-IO, consider these best practices:

TypeScript Support

Include TypeScript definitions for better developer experience

Documentation

Provide clear README with installation and usage examples

Peer Dependencies

List vk-io as a peer dependency to avoid version conflicts

Testing

Include tests to ensure reliability and prevent regressions
Package naming convention: Use vk-io-* prefix for community packages to make them easily discoverable on npm.

Contributing Guide

Learn how to contribute to VK-IO core

Examples

Explore example implementations

Build docs developers (and LLMs) love

Get started for freeTalk to us