🚀 FURSY v0.2.0 Released - Documentation & Examples

[kolkov]

Release Date: January 18, 2025

We're excited to announce FURSY v0.2.0 - a major documentation and developer experience release! 🎉

This release focuses on making FURSY more accessible and easier to learn, with comprehensive examples, guides, and a new validation plugin.

---

🎯 What's New

🔍 Validator Plugin

New plugins/validator package with professional validation support:

type CreateUserRequest struct {
    Email    string `json:"email" validate:"required,email"`
    Password string `json:"password" validate:"required,min=8"`
    Age      int    `json:"age" validate:"required,gte=18,lte=120"`
}

// Validation happens automatically before handler is called
fursy.POST[CreateUserRequest, UserResponse](router, "/users", handler)

• ✅ 100+ validation tags (go-playground/validator/v10)
• ✅ RFC 9457 Problem Details error conversion
• ✅ Custom error messages
• ✅ 94.3% test coverage

📚 Comprehensive Documentation

7,000+ lines of documentation added to README.md and new llms.md:

• Middleware Guide - All 8 built-in middleware with examples
• Validation Guide - Type-safe request validation patterns
• Content Negotiation - RFC 9110 compliant, AI agent friendly
• Observability - OpenTelemetry integration with Jaeger/Prometheus
• llms.md - Complete guide for AI-assisted development (1,716 lines)

💡 11 Working Examples

5,000+ lines of production-ready example code:

Beginner (30 min):

• 01-hello-world - Minimal setup (<30 lines)
• 02-rest-api-crud - Complete CRUD API

Intermediate (2 hours):

• 04-content-negotiation - Multi-format responses (JSON/HTML/Markdown/XML)
• 05-middleware - All 8 middleware + 8 custom patterns
• 06-opentelemetry - Distributed tracing + metrics with Docker setup

Advanced (1 hour):

• validation/ - 6 progressive validation examples (basic → production)

Progressive Learning Path: examples/README.md guides you through ~3.5 hours of hands-on learning.

---

📊 By The Numbers

• 79 files changed: +14,146 lines
• 11 complete examples: 5,000+ lines of code
• 91.7% test coverage (maintained)
• 0 linter issues (34+ linters enabled)
• 100% backward compatible with v0.1.0

---

🚀 Try It Now

Installation

go get github.com/coregx/fursy@v0.2.0

Quick Start

# Clone the repo
git clone https://github.com/coregx/fursy.git
cd fursy/examples/01-hello-world

# Run the example
go run main.go

# Visit http://localhost:8080

All examples are ready to run - just go run main.go!

---

📖 Resources

• 📦 Release: https://github.com/coregx/fursy/releases/tag/v0.2.0
• 📚 Documentation: https://pkg.go.dev/github.com/coregx/fursy
• 💡 Examples: https://github.com/coregx/fursy/tree/main/examples
• 📝 Changelog: https://github.com/coregx/fursy/blob/main/CHANGELOG.md
• 🗺️ Roadmap: https://github.com/coregx/fursy/blob/main/ROADMAP.md

---

🎯 What Makes FURSY Different?

1. Type-Safe Generics - Box[Req, Res] for compile-time safety
2. RFC 9457 Native - Standardized error responses built-in
3. Production-Ready - JWT, rate limiting, circuit breaker, graceful shutdown
4. Zero Dependencies - Core routing uses stdlib only
5. Modern Go - Requires Go 1.25+ (encoding/json/v2, log/slog)
6. Performance - 256-326 ns/op routing, 1 alloc/op

---

🛣️ What's Next

v0.3.0+ will bring ecosystem expansion:

• Database middleware (PostgreSQL, MySQL, SQLite)
• Cache middleware (Redis, Memcached)
• Documentation website (fursy.coregx.dev)
• Migration guides from Gin, Echo, Chi

See ROADMAP.md for details.

---

💬 We Want Your Feedback!

This release focuses on developer experience. We'd love to hear:

• 🤔 Which examples were most helpful?
• 📚 What documentation could be improved?
• 🐛 Any issues or bugs you encountered?
• 💡 Feature requests for v0.3.0+?

Please share your thoughts in the comments below or open an issue!

---

🙏 Thank You

Special thanks to:

• Everyone who tested v0.1.0 and provided feedback
• The Go community for inspiration and best practices
• Claude Code for AI-assisted development

Star the repo ⭐ if you find FURSY useful!

---

Happy coding! 🎉

— FURSY Team