English | ็ฎไฝไธญๆ
Sponge is a powerful and easy-to-use Go development framework. Built on the core philosophy of "Definition is Code", it aims to reshape the backend development experience through automatic generation technology, unleashing productivity and boosting development efficiency.
Sponge deeply integrates a code generation engine, Gin (Web framework), and gRPC (microservice framework), covering the full software lifecycle from project generation, development, and testing to API documentation and deployment.
Core Features:
- Definition-Driven Development: Automatically parses SQL, Protobuf, and JSON configuration files to generate high-quality modular code.
- LEGO-style Assembly: Flexibly combines code modules in a loosely coupled manner, supporting the rapid construction of monolithic applications, microservice clusters, and gateway services, including
RESTful API,gRPC,HTTP+gRPC,gRPC Gateway, etc. - Low Code, High Efficiency: Eliminate the tedious, repetitive tasks of building underlying frameworks, developing CRUD operations, and configuring routing and governance. This allows developers to focus solely on core business logic and rapidly deliver standardized, high-quality backend services.
- Extreme Development Efficiency: One-click generation of complete, production-ready backend services, including CRUD, routing, documentation, and service framework code, multiplying development efficiency.
- Out-of-the-box Toolchain: Provides a complete development toolchain (Generation โ Business Logic โ Testing โ Deployment โ Monitoring), eliminating the need to piece together fragmented tools.
- Industry Best Practices: Built on the mainstream Go community tech stack (Gin/GORM/gRPC/Protobuf, etc.), with a standardized architecture to reduce technology selection risks.
- Extremely Low Learning Curve: Easy to get started and beginner-friendly, while also meeting the customization needs of senior developers.
- Ideal for Team Collaboration: Unifies project structure, improving team collaboration efficiency and code maintainability.
- Flexible and Extensible: Supports custom templates, not limited to Go; capable of extending to frontend, test scripts, and other arbitrary code generation.
- AI-Driven Development (AI-Native):
- Sponge: automatically builds standardized infrastructure (API, data layer, service framework).
- AI Assistant: analyzes project context and generates code intelligently fill in core business logic based on project context, achieving "Infrastructure Automation, Business Intelligence".
Sponge is suitable for building high-performance, maintainable backend systems, specifically for:
- Rapid development of RESTful API services.
- Building large-scale microservice architectures.
- Cloud-native application development.
- Rapid refactoring and migration of legacy projects.
- Standardized engineering templates for Go beginners or teams.
No installation required, experience the code generation feature directly in your browser: Code Generation
Note: If you need to run the downloaded service code locally, you must first complete the local installation of Sponge.
-
Install Sponge: Supports Windows, macOS, Linux, and Docker environments. View the Sponge Installation Guide.
-
Open the Code Generation UI Page
sponge run
Access
http://localhost:24631in your local browser to generate code. -
Example: One-click Generation of Web Service Backend Code Based on SQL
- Operation Process:
- Fill Parameters: Connect to the database and select tables in the UI.
- Download Code: Click generate and download the complete project package.
- Generate Swagger Documentation: Execute
make docsin the project root directory. - Start Service: Execute
make run. - Test Interface: Access
http://localhost:8080/swagger/index.htmlin the browser to test APIs via the Swagger interface.
- Operation Process:
Sponge follows the "batteries included" principle, integrating 30+ mainstream Go ecosystem components, loaded on demand:
| Category | Component |
|---|---|
| Frameworks | Gin, gRPC |
| Database | GORM (MySQL, PostgreSQL, SQLite, etc.), MongoDB |
| Cache/Messaging | Redis, Kafka, RabbitMQ |
| Service Governance | Etcd, Consul, Nacos, Jaeger, Prometheus, OpenTelemetry |
| Others | DTM (Distributed Transaction), WebSocket, Swagger, PProf |
| ... | ... |
๐ View the complete list of tech stacks and components.
Sponge provides multiple code generation engines, supporting built-in templates, custom templates, and AI-assisted generation.
- Code generation engine based on built-in templates, as shown below:
- Code generation engine based on custom templates, as shown below:
- Code generation engine based on AI-assisted business logic, as shown below:
The code generated by Sponge follows a typical layered architecture with built-in service governance capabilities. The structure is clear and easy to maintain. The microservice framework structure of Sponge is shown below:
Based on tests with 50 concurrency and 1 million requests, services generated by Sponge demonstrate excellent performance:
๐ View detailed test code and environment.
The service code directory structure created by Sponge follows the project-layout, supporting Monolith, Multi-Repo, and Mono-Repo patterns.
1. Monolith / Multi-Repo Structure Details.
.
โโโ api # Directory for protobuf files and generated *pb.go files
โโโ assets # Directory for other assets used with the repository (images, logos, etc.)
โโโ cmd # Main application entry directory
โโโ configs # Directory for configuration files
โโโ deployments # Deployment scripts directory for bare metal, docker, k8s
โโโ docs # Directory for design documents and interface documentation
โโโ internal # Private application and library code directory
โ โโโ cache # Cache directory wrapped based on business logic
โ โโโ config # Go structure configuration file directory
โ โโโ dao # Data access directory
โ โโโ database # Database directory
โ โโโ ecode # Custom business error code directory
โ โโโ handler # HTTP business functionality implementation directory
โ โโโ model # Database model directory
โ โโโ routers # HTTP routing directory
โ โโโ rpcclient # Client directory for connecting to gRPC services
โ โโโ server # Service entry, including http, grpc, etc.
โ โโโ service # gRPC business functionality implementation directory
โ โโโ types # HTTP request and response types directory
โโโ pkg # Library directory that can be used by external applications
โโโ scripts # Execution scripts directory
โโโ test # Additional external test applications and test data
โโโ third_party # Directory for dependent third-party protobuf files or other tools
โโโ Makefile # Collection of commands related to development, testing, and deployment
โโโ go.mod # Go module dependency and version control file
โโโ go.sum # Go module dependency checksum file2. Mono-Repo Structure Details.
.
โโโ api
โ โโโ server1 # Protobuf files and generated *pb.go directory for Service 1
โ โโโ server2 # Protobuf files and generated *pb.go directory for Service 2
โ โโโ server3 # Protobuf files and generated *pb.go directory for Service 3
โ โโโ ...
โโโ server1 # Code directory for Service 1, basically same structure as multi-repo
โโโ server2 # Code directory for Service 2, basically same structure as multi-repo
โโโ server3 # Code directory for Service 3, basically same structure as multi-repo
โโโ ...
โโโ third_party # Dependent third-party protobuf files
โโโ go.mod # Go module dependency and version control file
โโโ go.sum # Go module dependency checksum fileClick to view the Official Sponge Documentation, covering core content such as development guides, components, service configuration, and deployment solutions.
- Web Service (based on SQL, includes CRUD)
- gRPC Microservice (based on SQL, includes CRUD)
- Web Service (based on Protobuf)
- gRPC Microservice (based on Protobuf)
- gRPC Gateway Service (Gateway)
- gRPC+HTTP Microservice (based on Protobuf)
- Community Backend Service
- Community Service Microservice Split
- E-commerce Distributed Order System
- E-commerce Flash Sale System (DTM + FlashSale)
- E-shop System
- Appliance Store Management
Issues and PRs are welcome! Contribution Guide.
If Sponge is helpful to you, please give it a โญ Star! This will be our motivation for continuous updates.







