Logo Dark Logo Sphere Documentation
  • sphere ↗
  • sphere-cli ↗
  • sphere-layout ↗
  • sphere-simple-layout ↗
  • protoc-gen-route ↗
  • protoc-gen-sphere ↗
  • protoc-gen-sphere-binding ↗
  • protoc-gen-sphere-errors ↗
CTRL K
    GitHub
    CTRL K
      • Docs
        • Getting Started
          • Quick Start
          • Development Workflow
        • Core Concepts
          • Project Structure
          • Proto Packages
          • Protocol & Codegen
          • Runtime & Server
          • Architecture & Repository Strategy
        • Components
          • sphere-cli
          • protoc-gen-route
          • protoc-gen-sphere
          • protoc-gen-sphere-binding
          • protoc-gen-sphere-errors
        • Guides
          • API Definitions
          • Error Handling
          • Logging
      Made with love by TBXark

      Protobuf-first Go service framework 
      for definition-driven development

      Start monolithic, scale to microservices. Define once, generate everything with rapid tooling.

      Get Started

      Protocol-First Design

      Define once in Protobuf, generate everywhere. Get Go handlers, HTTP routing, client SDKs, and OpenAPI docs from a single source of truth.

      Pragmatic Monolith Template

      Start simple with Gin + Wire + Ent in a single binary. Clean architecture that scales from MVP to microservices when needed.

      Complete Code Generation

      Automated toolchain with protoc-gen-sphere ecosystem: server stubs, HTTP routing, field binding, typed errors, and validation.

      Structured Error Handling

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

      Full-Stack Development

      Generate Swagger documentation, TypeScript SDKs, and validation schemas. Bridge backend and frontend with type safety.

      Developer Experience

      sphere-cli for project scaffolding, Makefile workflows, and clean project structure. Focus on business logic, not boilerplate.