velocity

Velocity

A Laravel-inspired web framework for Go

Velocity brings joy and elegance to Go web development, without sacrificing Go's simplicity, performance, and type safety. Build web applications with expressive APIs and the speed of Go.

Why Velocity?

For Framework Users: Get familiar conventions and developer happiness you love, with Go's performance and concurrency.

For Go Developers: Skip the boilerplate and focus on building. Velocity provides a unified, elegant interface over common web development tasks.

Key Features

• Single Binary: Deploy anywhere with zero dependencies
• Type Safety: Full compile-time type checking with Go's type system
• True Concurrency: Built-in goroutines and channels for high performance
• Driver-Based Architecture: Swap implementations via config (Redis ↔ Memory, PostgreSQL ↔ MySQL)
• Expressive DX: Familiar conventions, expressive APIs, and developer-friendly errors

Requirements

• Go 1.25 or higher
• Node.js 18+ (for frontend assets)

CLI Installation

Install the Velocity CLI to create and manage projects:

# Homebrew (macOS)
brew tap velocitykode/tap
brew install velocity

# Or with Go
go install github.com/velocitykode/velocity-cli@latest

Verify installation:

velocity version

Quick Start

Create a new project:

velocity new myapp
cd myapp
velocity serve

Your app runs at http://localhost:3000

Manual Setup

Add the framework to an existing project:

go get github.com/velocitykode/velocity

package main

import (
    "github.com/velocitykode/velocity/pkg/router"
    "github.com/velocitykode/velocity/pkg/log"
)

func main() {
    r := router.New()

    r.Get("/", func(c *router.Context) error {
        return c.JSON(200, map[string]string{
            "message": "Welcome to Velocity!",
        })
    })

    log.Info("Starting server on :8080")
    r.Run(":8080")
}

Feature Status

Documentation

Full documentation at velocitykode.com/docs

• Getting Started
• CLI Reference
• Core Concepts
• Database
• Frontend
• Advanced

Community

• GitHub Discussions - Ask questions and share ideas
• Issues - Report bugs and request features
• Contributing - Contribution guidelines

Philosophy

Velocity is built on three principles:

1. Developer Happiness: Code should be a joy to write and read
2. Convention over Configuration: Sensible defaults, configure only when needed
3. Go's Strengths: Embrace simplicity, performance, and type safety

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Velocity is open-source software licensed under the MIT License.