VPKG Package Catalog

VPKG Package Catalog

VPKG (Vandor Packages) is Vandor's package system for infrastructure components. Unlike traditional package managers, VPKG copies source code directly into your project. You own it, you can read it, and you can modify it however you want.

Vandor v0.4 ships with 8 official packages covering the most common backend infrastructure needs.

Package Tiers

Packages are organized into three tiers based on who maintains them and how they are reviewed:

For production projects, we recommend starting with official packages.

Searching and Browsing

You can discover packages from the command line:

# Search by keyword
vandor vpkg search http
vandor vpkg search database
vandor vpkg search cache

# View details about a specific package
vandor vpkg info @official/http-humachi

# List all available packages
vandor vpkg search

Official Packages

@official/http-humachi

HTTP server with Chi router and Huma v2.

This is the primary transport package for building web APIs. It provides a production-ready HTTP server with routing, middleware, request/response handling, and OpenAPI documentation support through Huma.

Provides:

• Chi router with middleware chain
• Huma v2 for typed request/response handling and OpenAPI generation
• Common middleware (logging, recovery, CORS)
• FX module for dependency injection wiring
• Handler registration pattern

Key actions:

• add-handler -- Scaffold a new HTTP handler for a use case

Install:

vandor vpkg add @official/http-humachi

@official/entgo

Database ORM with Ent.go.

Provides a type-safe ORM layer using Ent.go. It generates Go code from schema definitions, giving you a strongly-typed database client with zero runtime reflection.

Provides:

• Ent.go client setup and FX module
• Schema-based code generation
• Repository pattern integration
• Database connection management

Key actions:

• add-schema -- Create a new Ent.go schema file
• generate -- Run Ent.go code generation

Install:

vandor vpkg add @official/entgo

@official/atlas

Database migrations with Atlas.

Provides database schema migration management using Atlas. Works alongside the Ent.go package for a complete database workflow: define schemas, generate migrations, apply them.

Provides:

• Atlas migration configuration
• Migration file management
• Up/down migration support
• Migration status tracking

Key actions:

• migrate-diff -- Generate a migration from schema changes
• migrate-up -- Apply pending migrations
• migrate-down -- Rollback migrations
• migrate-status -- Show migration status

Install:

vandor vpkg add @official/atlas

@official/redis-cache

Redis caching layer.

Adds a Redis-backed caching layer to your project. Provides connection management, a caching interface, and FX wiring.

Provides:

• Redis client setup and FX module
• Caching interface with get/set/delete operations
• Connection health checks
• Configuration for connection pooling and timeouts

Key actions:

• None -- this package provides infrastructure only

Install:

vandor vpkg add @official/redis-cache

@official/asynq

Background job processing with Asynq.

Adds async job processing using Asynq (backed by Redis). Lets you define jobs in your domain layer and process them asynchronously with retries, scheduling, and priority queues.

Provides:

• Asynq server and client setup
• Job handler registration pattern
• Queue configuration (priorities, concurrency)
• FX module for wiring
• Dead letter queue support

Key actions:

• add-job -- Scaffold a new background job handler

Install:

vandor vpkg add @official/asynq

@official/runner-go-cron

Scheduled tasks with go-cron.

Adds scheduled/recurring task support using go-cron. Define cron jobs that run on a schedule within your application.

Provides:

• go-cron scheduler setup and FX module
• Cron job registration pattern
• Schedule expression support (cron syntax)
• Job lifecycle management

Key actions:

• add-cron-job -- Scaffold a new scheduled job

Install:

vandor vpkg add @official/runner-go-cron

@official/storage-s3

S3-compatible object storage.

Adds S3-compatible object storage support. Works with AWS S3, MinIO, and any S3-compatible storage provider.

Provides:

• S3 client setup and FX module
• Upload, download, and delete operations
• Presigned URL generation
• Bucket management
• Configuration for endpoints, credentials, and regions

Key actions:

• None -- this package provides infrastructure only

Install:

vandor vpkg add @official/storage-s3

@official/observability

Logging and tracing with OpenTelemetry.

Adds structured observability to your application using OpenTelemetry. Provides distributed tracing, metrics collection, and enhanced logging.

Provides:

• OpenTelemetry tracer and meter setup
• Trace propagation across HTTP and async boundaries
• Structured logging integration
• FX module for wiring
• Exporter configuration (OTLP, Jaeger, Prometheus)

Key actions:

• None -- this package provides infrastructure only

Install:

vandor vpkg add @official/observability

Common Package Combinations

Here are typical setups for different project types:

Web API

vandor vpkg add @official/http-humachi
vandor vpkg add @official/entgo
vandor vpkg add @official/atlas

Web API with Caching

vandor vpkg add @official/http-humachi
vandor vpkg add @official/entgo
vandor vpkg add @official/atlas
vandor vpkg add @official/redis-cache

Full-Stack Backend

vandor vpkg add @official/http-humachi
vandor vpkg add @official/entgo
vandor vpkg add @official/atlas
vandor vpkg add @official/redis-cache
vandor vpkg add @official/asynq
vandor vpkg add @official/storage-s3
vandor vpkg add @official/observability

Background Worker

vandor vpkg add @official/entgo
vandor vpkg add @official/atlas
vandor vpkg add @official/asynq
vandor vpkg add @official/runner-go-cron

Core-Only (CLI, Library)

No packages needed. Your domain layer works without any infrastructure.

Managing Packages

# Install a package
vandor vpkg add @official/http-humachi

# Remove a package
vandor vpkg remove @official/redis-cache

# Check package health
vandor vpkg doctor

# Auto-fix issues
vandor vpkg doctor --fix

# Sync from lockfile (after cloning or pulling)
vandor vpkg sync

Next Steps