Skip to content

Release v0.5.0: First release

Choose a tag to compare

@liorcodev liorcodev released this 22 Jan 18:50
· 16 commits to main since this release

[0.5.0] - 2026-01-22

Added

🧪 Interactive API Testing (Killer Feature)

  • Live endpoint testing - Test APIs directly from documentation with real fetch requests
  • Smart request builder with pre-filled JSON from schemas (required fields only)
  • Optional fields manager - Click-to-add badges for optional parameters
  • Custom header management - Add auth tokens, content-type, custom headers
  • Header persistence - Save/load common headers (localStorage)
  • Auto-method detection - GET for queries, POST for mutations
  • Real-time response display - Formatted JSON with syntax highlighting
  • Status indicators - Visual success/error badges
  • Debug information - Full request details on errors (URL, headers, body)
  • Configurable endpoint URL - Point to localhost, staging, or production

📚 Documentation Generation

  • Core functionality for automatic tRPC documentation generation
  • collectRoutes() function for router traversal and route extraction
  • generateDocsHtml() function for beautiful HTML documentation generation
  • Automatic schema extraction from Zod validators via toJSONSchema() method
  • Smart TypeScript type generation from JSON schemas
  • JSON example generation with realistic data
  • Optional field detection and documentation
  • Support for complex Zod schemas:
    • Objects with nested properties
    • Arrays and tuples
    • Unions (oneOf/anyOf)
    • Intersections (allOf)
    • Enums and literals
    • Optional and required fields

Features

Route Metadata Support

  • Route names and descriptions
  • Tag-based grouping
  • Authentication requirement indicators
  • Role-based access control badges
  • Deprecation warnings

Modern UI Components

  • Responsive design (mobile, tablet, desktop)
  • Sidebar navigation with smooth scrolling
  • Expandable route cards with detailed information
  • Visual procedure type badges (query/mutation/subscription)
  • Authentication and role badges
  • Syntax-highlighted code blocks
  • Smooth animations and transitions
  • Professional glassmorphism effects
  • Statistics overview with route counts

Developer Experience

  • Full TypeScript support with type definitions
  • Zero configuration required
  • Works with any tRPC v11 router
  • Deploy anywhere (Express, Next.js, Cloudflare Workers, etc.)
  • Self-contained HTML output (no external dependencies)

🔌 Fetch Logic & API Communication

  • Native Fetch API integration - Direct HTTP requests to tRPC endpoints
  • Automatic method selection - GET for queries, POST for mutations
  • Query parameter serialization - Automatic input encoding for GET requests
  • Request body handling - JSON serialization for POST requests
  • Response parsing - Smart content-type detection and JSON parsing
  • Error handling - Comprehensive error catching and user feedback
  • Base URL configuration - Configurable endpoint with localStorage persistence
    • Modal-based configuration UI with validation
    • Full URL validation (requires protocol http:// or https://)
    • Helpful hints about including mount path (e.g., /trpc)
    • CORS troubleshooting guidance - Warns about host matching (localhost vs 127.0.0.1)
    • Persistent storage across sessions
    • Visual button state shows when configured
  • Header management - Custom headers support with persistence
  • Loading states - Visual feedback during request lifecycle
  • Debug information - Full request details displayed on errors