How xulbux/svg-api works
SVG API is a Cloudflare Workers engine that turns URL requests into dynamic SVG badges, service metrics, icons, stacks, typing animations, and quote cards; it also serves a website with documentation and an interactive URL builder. The principal runtime path is request handling, route interpretation, optional live-metric retrieval, then SVG generation. The graph preserves the documented render modes and website capabilities. Some routing and page wiring is unsampled, so those links are marked unverified rather than presented as inspected calls.
Main entry points: svg.ts SVG Route · fetcher.ts Metric Fetcher · index.ts Worker Entry · renderer.ts Badge Renderer
Components 22
Worker Runtime
- Worker Entry
src/index.ts - HTTP Routes
src/routes/http.ts - Route Schema
src/routes/schema.ts - SVG Route
src/routes/svg.ts - Parameter Parsing
src/routes/params.ts
Live Services
- Service Presets
src/config/services.ts - Metric Fetcher
src/services/fetcher.ts - Metric Formatting
src/services/metrics.ts - Endpoint Helpers
src/services/endpoint.ts - Edge Cache
src/services/edgeCache.ts
SVG Rendering
- Badge Renderer
src/svg/renderer.ts - Icon Renderer
src/svg/icons.ts - Stack Renderer
src/svg/stack.ts - Typing Renderer
src/svg/typing.ts - Quote Renderer
src/svg/quote.ts - SVG Primitives
src/svg/shared.ts
Website and Builder
- Website Pages
src/site/pages - Service Docs
src/site/catalog/services.ts - Builder Controls
src/site/components/BuilderControls.tsx - Builder Client
src/site/client/builder
Other components
- URL Client
- Public Registries
Connections 22
- URL Client → Worker Entry: requests URL
README.md - Worker Entry → HTTP Routes: dispatches requests
src/index.ts - HTTP Routes → Route Schema: routes requests
- Route Schema → SVG Route: describes endpoints
src/routes/schema.ts - SVG Route → Parameter Parsing: parses options
src/routes/svg.ts - SVG Route → Metric Fetcher: resolves metrics
src/routes/svg.ts - SVG Route → Badge Renderer: renders badges
src/routes/svg.ts - SVG Route → Stack Renderer: renders stacks
src/routes/svg.ts - SVG Route → Typing Renderer: resolves typing layout
src/routes/svg.ts - SVG Route → Quote Renderer: renders quotes
src/routes/schema.ts - Service Presets → Metric Fetcher: configures services
src/config/services.ts - Metric Fetcher → Endpoint Helpers: reads responses
src/services/fetcher.ts - Metric Fetcher → Edge Cache: caches responses
src/services/fetcher.ts - Metric Fetcher → Public Registries: fetches metrics
- Metric Formatting → Endpoint Helpers: builds metrics
src/services/metrics.ts - Badge Renderer → Icon Renderer: renders icons
src/svg/renderer.ts - Badge Renderer → SVG Primitives: uses primitives
src/svg/renderer.ts - Typing Renderer → Icon Renderer: resolves icons
src/svg/typing.ts - Typing Renderer → SVG Primitives: uses primitives
src/svg/typing.ts - Worker Entry → Website Pages: serves pages
src/index.ts - Website Pages → Service Docs: shows service catalog
src/site/pages/ServicesPage.tsx - Builder Controls → Builder Client: uses builder logic