RapidGo

README

RapidGo Framework

A modern Go web framework inspired by Laravel and CodeIgniter — combining Laravel-style developer experience with Go performance.

Overview

RapidGo is an opinionated, full-stack Go web framework built on proven libraries (Gin, GORM, Cobra) that provides everything needed for web applications, REST APIs, and real-time WebSocket services.

Key Features

• MVC + Services + Helpers architecture
• Service Container & Providers — Laravel-style IoC for extensibility
• Multi-database support — PostgreSQL, MySQL, SQLite via GORM
• Session management — DB, Redis, File, Memory, Cookie backends
• Built-in validation — zero-dependency validator + struct-based (go-playground)
• Built-in crypto — AES-256-GCM, HMAC-SHA256, secure random tokens
• JWT & session-based authentication
• CLI scaffolding — make:controller, make:model, make:service, etc.
• Middleware registry — aliases, groups, custom middleware
• WebSocket support — via coder/websocket
• Caching — Redis and in-memory backends
• Mail — SMTP via go-mail
• File storage — local disk and S3
• Events / hooks — pub-sub event dispatcher
• i18n / localization — JSON translation files
• Caddy integration — embedded or reverse proxy (optional)
• Docker support — multi-stage builds (optional)
• Graceful shutdown, health checks, CSRF, CORS, rate limiting

Project Status

Phase: All 56 features shipped (Phases 1–6 complete)

The framework is feature-complete with full test coverage across 39+ packages. All features were built following the Mastery development process.

Documentation

All documentation lives in the docs/ directory:

• Project Context — What RapidGo is, technology stack, architecture
• Project Roadmap — Feature plan, dependencies, progress
• Mastery Process — Development workflow and standards
• Framework Reference — Complete framework documentation

Quick Start

# Setup
cp .env.example .env   # then edit .env with your credentials

# Build
make build

# Run
make run

# Test
make test

Repository

• GitHub: RAiWorks/RapidGo

Tech Stack

Component	Library
HTTP Router	Gin
ORM	GORM
CLI	Cobra
Config	godotenv
JWT	golang-jwt
WebSocket	coder/websocket
Redis	go-redis
Mail	go-mail
S3	aws-sdk-go-v2
Scheduler	robfig/cron
TOTP	pquerna/otp
GraphQL	graphql-go
OAuth2	x/oauth2
Metrics	prometheus

License

MIT License. See LICENSE for details.

Copyright (c) 2026 RAi Works (https://rai.works)