Logo Dark Logo Sphere Documentation
  • sphere-cli ↗
  • protoc-gen-route ↗
  • protoc-gen-sphere ↗
  • protoc-gen-sphere-binding ↗
  • protoc-gen-sphere-errors ↗
  • sphere-layout ↗
  • sphere-bun-layout ↗
  • sphere-simple-layout ↗
CTRL K
    GitHub
    CTRL K
      • Docs
        • Getting Started
          • Quick Start
          • Development Workflow
        • Core Concepts
          • Design Philosophy
          • Project Structure & Architecture
          • Makefile Contract
          • Protocol & Code Generation
          • Proto Packages & Runtime
        • Components & Tools
          • sphere-cli
          • protoc-gen-route
          • protoc-gen-sphere
          • protoc-gen-sphere-binding
          • protoc-gen-sphere-errors
        • Guides
          • API Definitions
          • Error Handling
          • Customizing the Stack
          • Logging
      Made with love by TBXark

      Thin integration layer 
      for definition-driven development

      Compose mature Go tools with Protobuf contracts, small adapters, code generators, templates, and Makefile-driven workflows.

      Get Started

      Protocol-First Design

      Use Protobuf as the service contract. Generate transport glue, binding metadata, typed errors, and documentation from the same source.

      Replaceable Defaults

      Official templates pick Gin, Ent or Bun, Wire, Buf, and Swagger, but those choices remain visible and replaceable.

      Makefile Workflow

      The CLI creates a project; the generated Makefile owns init, generation, formatting, linting, running, and builds.

      Focused Code Generation

      The protoc-gen-sphere ecosystem creates repeatable plumbing while business logic stays in ordinary Go packages.

      Structured Error Handling

      Define error enums in protobuf with automatic HTTP status mapping. Get consistent JSON responses with code, reason, and message.

      Customizable Stack

      Swap routers, persistence, dependency injection, documentation, or deployment flow while keeping the same project contracts.