TurboGo

🌀 TurboGo — High Performance Middleware-First Go Framework

TurboGo is a blazing-fast, middleware-first, and event-driven web framework built with Go — inspired by Express, but optimized for high concurrency, clean extensibility, and developer control.

TurboGo Key Features are :

• Middleware-first — use .Use()
• Ultra-fast router & context engine
• Built-in async engines (PubSub, Queue, Cache)
• Extensible and clean internal architecture
• Optional middleware: Auth, Logger, Recovery, Auto-cache
• CLI generator: npx create-turbogo for instant project scaffolding

🧭 Request Lifecycle Overview

                           ┌────────────┐
                           │   Client   │
                           └────┬───────┘
                                │
                                ▼
                        ┌───────────────┐
                        │  HTTP Router  │  ← core/routing.go
                        └─────┬─────────┘
                              ▼
              ┌────────────────────────────────┐
              │  Turbo Middleware Pipeline      │ ← middleware/logger.go, auth.go, etc.
              └────────┬───────────────────────┘
                       ▼
        ┌────────────────────────────────────────────┐
        │ Redis Auto-Cache Layer (Check & Set)        │ ← middleware/cache.go
        └────────┬──────────────────────────────┬─────┘
                 ▼                              ▼
          Cache Hit → Return JSON       Cache Miss → Proceed
                                                 │
                                                 ▼
                           ┌──────────────────────────────┐
                           │     Handler Logic (Dev)      │ ← developer handler: func(ctx *Context)
                           └──────────────┬───────────────┘
                                          ▼
                     ┌────────────────────────────────────────────┐
                     │       Embedded Infrastructure Engine       │ ← core/context.go
                     └──────┬────────────┬────────────┬───────────┘
                            ▼            ▼            ▼
                         Redis         Kafka       RabbitMQ
                      (inmem.go)   (pubsub.go)   (taskqueue.go)
                            ▼            ▼            ▼
                         persist       persist       persist
                          (.json)       (.log)        (.log)
                                ▼
                        Response + Cache Set

🔐 Example: Auth Middleware

Use the built-in auth middleware with environment variable AUTH_SECRET:

app.Use(middleware.Auth(os.Getenv("AUTH_SECRET")))

Set your secret in .env:

export AUTH_SECRET=supersecurekey123

🚀 Getting started

Manual Installation TurboGo

go get github.com/Dziqha/TurboGo

TurboGo CLI (npx create-turbogo)

Scaffold TurboGo apps instantly via CLI.

npx create-turbogo myapp

Prompted features:

• ✅ Controller name
• 📁 Structure auto-generated

⚠️ We intentionally use Node.js to overcome limitations of Go's CLI tooling, especially for rich interactive workflows.

Running TurboGo Example

Gin requires Go version 1.23 or above.

package main

import (
	"github.com/Dziqha/TurboGo"
	"github.com/Dziqha/TurboGo/core"
)

func main() {
	app := TurboGo.New()

	app.Get("/", func(c *core.Context) {
		c.Text(200, "Hello from TurboGo!")
	})

	app.RunServer(":8080")
}

To run the code, use the go run command, like:

go run example.go

Your TurboGo app will be available at http://localhost:8080

🧪 Benchmark Overview

Benchmarked on Windows amd64, Ryzen 5 5600H, Go 1.24. ⚠️ Results may vary—run on idle system for accuracy.

🤝 Contributing

Contributions are welcome — from fixing typos to suggesting ideas or building features. TurboGo grows through small steps, open discussions, and shared curiosity. Join the conversation on Discussions.

❤️ About

TurboGo is handcrafted with performance, simplicity, and extensibility in mind — empowering developers to build Go web backends without the bloat.

Ready to go fast? Build with TurboGo. 🌀 Give it a ⭐ on GitHub if you like it!

📄 License

This project is licensed under the MIT License

Built with love by @dziqha