grx

Gin

Forward GraphQL requests through Gin with wildcard routes and gin.WrapH.

Gin pairs well when your service already declares REST handlers with gin.Context helpers - you keep JSON validation, JWT middleware, telemetry, and http.Handler fallbacks aligned in one Engine.

grx stays a plain http.Handler; gin.WrapH lets Gin emit the response while http.StripPrefix keeps /api-visible URLs routed to /playground and /query.

Prep graph using Minimal schema.

Dependencies

go get github.com/gin-gonic/gin

main.go

package main

import (
	"log"
	"net/http"

	"example.com/hello-grx/graph"
	"github.com/gin-gonic/gin"
	"github.com/grx-gql/grx"
)

func main() {
	gql, err := grx.NewServer(
	grx.WithSchema(graph.Schema()),
		grx.WithPlaygroundPath("/playground"),
		grx.WithGraphQLPath("/query"),
	)
	if err != nil {
		log.Fatal(err)
	}

	delegated := http.StripPrefix("/api", gql)

	engine := gin.Default()
	engine.GET("/health", func(c *gin.Context) {
		c.String(200, "ok")
	})
	engine.Any("/api/*proxyPath", gin.WrapH(delegated))

	log.Println("GraphiQL: http://localhost:8080/api/playground")
	log.Println("GraphQL POST: http://localhost:8080/api/query")
	log.Fatal(engine.Run(":8080"))
}

Prefer composition over rewriting headers - wrap delegated (logging, JWT gating, request IDs) instead of patching Gin-specific hooks when possible.

Edit this page on GitHub

Last updated on

Chi

Mount grx on Chi routers with explicit prefix stripping alongside REST routes.

Echo

Bridge Echo routes to grx with echo.WrapHandler and wildcard paths.

On this page

Dependenciesmain.goRelated