VDK Hub Overview

Welcome to VDK Hub - your central platform for browsing, customizing, and generating AI assistant blueprints that make your development workflow smarter and more efficient.

What is VDK Hub?

VDK Hub is a comprehensive web platform (https://vdk.tools) that provides access to curated AI assistant blueprints organized across canonical domains. It serves as the central discovery and generation hub for the VDK ecosystem, working alongside VDK CLI and the VDK-Blueprints repository to deliver project-aware AI assistance.

Hub's role in the operating contract

VDK Hub is a discovery/distribution surface, not the runtime execution engine.

The ecosystem order is:

1. ai-context-schema
2. VDK-Blueprints
3. VDK-CLI
4. VDK-Hub
5. VDK-Wiki

CLI defines runtime retrieval, adaptation, and deployment semantics. Hub should mirror these semantics in filtering, compatibility indicators, and install guidance.

Why Use VDK Hub?

• 🎯 Project-Aware AI: Make your AI assistant understand your specific tech stack and coding patterns
• 🏆 Curated Quality: Access professionally crafted blueprints tested by the community
• ⚡ Time-Saving: No need to write AI rules from scratch or configure from zero
• 🌐 Multi-Platform: Works with Claude Code, Cursor, Windsurf, GitHub Copilot, and more
• 👥 Team Ready: Share configurations across teams for consistent development experience

Key Features

• 📚 Blueprint Catalog: Browse curated AI assistant blueprints organized by domain
• 🔍 Smart Search: Advanced filtering and search with full-text indexing
• ⚙️ Blueprint Generator: 7-step wizard for custom package creation
• 👤 Personal Collections: Save and organize your favorite blueprints with sharing capabilities
• 📦 One-Click Download: Get ready-to-use configuration packages for any platform
• 🔄 GitHub Integration: Automatic synchronization with blueprint repositories
• 🌓 Modern Interface: Clean, responsive design with dark/light themes
• 👥 Team Collaboration: Public collections and standardized practices

How It Works

Ecosystem Integration

📐 ai-context-schema → 📚 VDK-Blueprints → 💻 VDK-CLI → 🌐 VDK-Hub → 📘 VDK-Wiki

1. Discover - Browse curated blueprints with advanced filtering and compatibility indicators
2. Generate - Complete 7-step wizard to create custom packages for your tech stack
3. Select - Choose an artifact by canonical metadata (kind, specificity layer, platform compatibility)
4. Deploy - Install into your project using CLI deployment semantics (vdk deploy <blueprint-id>)
5. Integrate - Verify generated target files in your AI assistant/IDE
6. Collaborate - Share collections and maintain team standards

Getting Started

For New Users

1. Explore the Catalog - Start by browsing blueprints across canonical domains
2. Try the Generator - Use the 7-step wizard to create your first custom package
3. Create an Account - Sign up with GitHub OAuth to save collections and track downloads
4. Join the Community - Share feedback and contribute to the growing blueprint library

For Returning Users

• Quick Access - Jump to your Collections or recent downloads
• Stay Updated - Check for new blueprints in your favorite categories
• Contribute - Share your own blueprints with the community

Documentation Structure

This guide is organized to help you get the most out of VDK Hub:

Using VDK Hub

Learn how to use all the features and functionality in the Features Guide:

• Browsing Blueprints
• Using Search & Filters
• Creating Collections
• Blueprint Generator
• User Accounts

Understanding Blueprints

Learn what blueprints are and how they work:

• Canonical Blueprint Kinds: project-memory, conditional-rule, skill, command, workflow, agent, hook, mcp-integration, plugin-distribution
• Schema v3.0.0: Canonical metadata and platform mapping for interoperable adaptation
• Platform Adaptation: Automatic conversion to platform-specific formats

Curated retrieval behavior

• Default retrieval blends L0-L3 (generic to specific)
• L4 provenance variants are excluded by default and included only on explicit request
• Deployment outcomes should remain explicit (lossless, lossy, unsupported)

VDK Ecosystem

Understand the complete VDK ecosystem in the Ecosystem Guide:

• Ecosystem Overview - How VDK Hub, CLI, and Repository work together
• Component Integration - Deep dive into ecosystem connections
• Future Roadmap - What's coming next

Integration Guides

Learn how to use blueprints with different tools in the Integration Guides:

• Claude Code Integration
• Cursor Integration
• Windsurf Integration
• Custom Setups

Community & Support

Get help and contribute to the platform in the Community Guide:

• Getting Help
• Contributing Blueprints
• Best Practices
• FAQ

Quick Start Guide

1. Find What You Need

Navigate to Blueprints → Select your category → Browse available options

2. Generate Custom Package

Go to Generate → Answer setup questions → Download your package

3. Integrate with Your AI Assistant

Follow the integration guide for your specific AI assistant or IDE

Popular Use Cases

• New Project Setup: Generate AI configurations for your specific tech stack in minutes
• Team Standardization: Share blueprint collections across teams for consistent AI behavior
• Technology Learning: Discover expert best practices for React 19, Next.js 15, Supabase, etc.
• Productivity Boost: Experience 60% faster AI suggestions with project-aware configurations
• Platform Migration: Easily switch between Claude Code, Cursor, Windsurf, and GitHub Copilot

Community

VDK Hub thrives on community contributions:

• Share Your Blueprints: Help others by contributing your own AI rules
• Provide Feedback: Help improve existing blueprints
• Request Features: Suggest new categories or functionality
• Join Discussions: Connect with other developers using AI assistants

Support & Resources

• VDK Hub Platform: https://vdk.tools
• GitHub Repository: https://github.com/vdkit/VDK-Hub
• VDK-Blueprints Repository: https://github.com/vdkit/VDK-Blueprints
• VDK CLI: https://github.com/vdkit/VDK-CLI
• Documentation: Comprehensive guides for all components

Ready to transform your AI assistant into a project-aware expert? Start by exploring the blueprint catalog at https://vdk.tools or creating your first custom package with the 7-step generator wizard!