Go Framework

Neutron for Go is a lightweight web framework built on net/http. Type-safe generic handlers, composable middleware, and first-class Nucleus integration.

Features

• stdlib-based — 100% compatible with net/http ecosystem
• Generic handlers — HandlerFunc[In, Out any] with automatic extraction
• OpenAPI 3.1 — Auto-generated from route metadata
• RFC 7807 — Standardized error responses
• 14 data models — Full Nucleus client for all database models
• Real-time — WebSocket hub + SSE broadcasting

Hello World

package main

import (
    "context"
    "github.com/neutron-dev/neutron-go/neutron"
)

func main() {
    app := neutron.New(
        neutron.WithMiddleware(
            neutron.Logger(nil),
            neutron.Recover(),
            neutron.RequestID(),
        ),
    )

    neutron.Get(app.Router(), "/", func(ctx context.Context, _ neutron.Empty) (string, error) {
        return "Hello, Neutron!", nil
    })

    app.Run(":8080")
}

Package Structure

| Package | Purpose | |---------|---------| | neutron | Core framework (router, handlers, middleware, config) | | nucleus | Database client for all 14 Nucleus data models | | neutronauth | JWT, sessions, RBAC, API keys | | neutroncache | L1 (LRU) + L2 (Nucleus KV) tiered cache | | neutronjobs | Background job queue + cron scheduling | | neutronrealtime | WebSocket hub + SSE | | neutrontest | Test helpers | | neutroncli | Dev server, code generation, scaffolding |

App Configuration

app := neutron.New(
    neutron.WithLogger(slog.Default()),
    neutron.WithLifecycle(db.LifecycleHook()),
    neutron.WithOpenAPIInfo("My API", "1.0.0"),
    neutron.WithMiddleware(
        neutron.Logger(logger),
        neutron.Recover(),
        neutron.RequestID(),
        neutron.CORS(neutron.CORSOptions{AllowOrigins: []string{"*"}}),
        neutron.RateLimit(100, 1000),
        neutron.Timeout(30 * time.Second),
        neutron.Compress(gzip.DefaultCompression),
    ),
)

app.Run(":8080")  // Graceful shutdown on SIGTERM/SIGINT

Auto-provides:

• GET /health — Health check endpoint
• GET /openapi.json — OpenAPI 3.1 spec
• GET /docs — Swagger UI