examples

Examples

Learn sebuf through working examples

🚀 Start here: Simple API

Want to see sebuf in action immediately?

# Clone the repo and run the complete example
git clone https://github.com/SebastienMelki/sebuf.git
cd sebuf/examples/simple-api
make demo

This starts a working HTTP API with:

• User management and authentication
• Multiple auth methods (email, token, social)
• Type-safe request construction
• OpenAPI documentation
• JSON and binary protobuf support

→ Go to the Simple API Tutorial

What the example shows

✅ HTTP handlers from protobuf services
✅ Oneof helpers that eliminate boilerplate
✅ OpenAPI docs that stay in sync
✅ Multiple content types (JSON + binary protobuf)
✅ Real authentication patterns

More examples (coming soon)

• E-commerce API - Product catalog, cart, checkout
• Chat API - Real-time messaging with websockets
• File Upload API - Handle binary data and metadata
• Microservices - Inter-service communication patterns

Want to contribute an example?

We're looking for real-world examples that show sebuf solving actual problems. See Contributing Guidelines.

---

Start with the Simple API Tutorial →