Kashvi

Framework documentation

Kashvi is a Laravel-inspired Go web framework for APIs and web apps: ORM, migrations, JWT auth, caching, queues, WebSockets, gRPC, and a CLI for scaffolding. Use the map below to jump to guides and reference pages.

Made with care by an Indian developer.

Documentation map

Goal	Where to read
Install CLI, new project, first run	Installation & Quick Start
Full CRUD (model → DTO → migration → repo → tests)	Complete CRUD walkthrough
App logs and SQL (`LOG_LEVEL`, `DB_LOG_MODE`)	Logging on Installation
CLI (`migrate`, `make:resource`, …)	CLI reference
Routes, context, validation, auth	Routing, Context, Validation, Authentication

Key features

MVC + DTOs: Controllers, services, repositories, models, and request/response DTOs
Database ORM: GORM-backed queries (MySQL, PostgreSQL, SQLite, SQL Server)
Migrations & seeders: Versioned schema and data
Authentication: JWT middleware and optional RBAC
Caching & queues: Redis-oriented integrations
WebSockets & gRPC: Real-time and RPC alongside HTTP
Testing: TestKit with JSON scenario files
CLI: kashvi new, kashvi make:*, project-aware serve / migrate

Architecture

Kashvi follows MVC with a repository layer and DTOs for API contracts. Controllers bind JSON to DTOs, validate, call repositories or services, and respond.

┌─────────────────┐
│  Controllers    │ ← HTTP; bind DTOs, call services/repositories
├─────────────────┤
│      DTOs       │ ← Request/response structs (CreateXRequest, …)
├─────────────────┤
│    Services     │ ← Business logic (optional)
├─────────────────┤
│  Repositories   │ ← Data access; encapsulate ORM/DB calls
├─────────────────┤
│     Models      │ ← GORM models
├─────────────────┤
│   Database      │ ← Migrations & GORM
└─────────────────┘