Add badge collection feature with documentation and routes

- Implement BadgeCollectionController to render multiple badges as a single SVG.
- Create routes for badge collection and integrate with existing route registration.
- Update API documentation for badge collection endpoint.
- Add examples and error handling for badge collection requests.
- Bump version to 2.0.1 in package.json.

Author: pphatdev

docs/how-to/RELEASE_ICONS.md docs/RELEASE/RELEASE_ICONS.mddocs/how-to/RELEASE_ICONS.md renamed to docs/RELEASE/RELEASE_ICONS.md

@@ -20,6 +20,7 @@ Icons enhance release documentation by:
 - [Technology Stack Display](#technology-stack-display)
 - [Themed Icon Sets](#themed-icon-sets)
 - [Best Practices](#best-practices)
+- [Current Release (v2.0.1)](#current-release-v201)
 
 ---
 
@@ -297,6 +298,51 @@ Icons are SVGs served directly from the server. They're lightweight and render q
 
 ---
 
+## Current Release (v2.0.1)
+
+Use this section as a copy-ready template for the current release.
+
+### Highlights
+
+- Added `GET /badge/collection` to render multiple user badges into one SVG.
+- Added collection layout controls: `columns` and `gap`.
+- Added endpoint examples and documentation for badge collection in `docs/example/badge-collection.md`.
+- Fixed collection SVG composition to avoid duplicate `width`/`height` attributes.
+
+### Release Notes Template
+
+```markdown
+# Release v2.0.1
+
+![TypeScript](https://stats.pphat.top/icons/typescript?color=%233178C6) ![Node.js](https://stats.pphat.top/icons/nodedotjs?color=%23339933) ![GitHub](https://stats.pphat.top/icons/github?color=white)
+
+## Added
+- `GET /badge/collection` endpoint for multi-badge SVG output.
+- New docs: `docs/example/badge-collection.md`.
+
+## Improved
+- Better layout customization for badge collections using `columns` and `gap`.
+
+## Fixed
+- XML parsing issue in composed badge SVGs caused by duplicate attributes.
+
+## Quick Demo
+![badge-collection](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories&columns=3)
+```
+
+### Release Badge Examples (v2.0.1)
+
+```markdown
+![version](https://img.shields.io/badge/version-2.0.1-22c55e)
+![badge-collection-demo](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,followers&columns=2&gap=10)
+```
+
+Preview:
+
+![badge-collection-demo](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,followers&columns=2&gap=10)
+
+---
+
 ## Advanced Examples
 
 ### Changelog with Icons

docs/example/README.md

@@ -10,11 +10,12 @@ This folder contains one file per route, with demo examples for each available o
 - [GET /icons and /icons/:name](./icons.md)
 - [GET /icons (Collection Mode)](./icon-collection.md)
 - [GET /badge/:type](./badge-user.md)
+- [GET /badge/collection](./badge-collection.md)
 - [GET /project/:type](./project.md)
 
 ## Additional Guides
 
-- [Release Icons Documentation](../how-to/RELEASE_ICONS.md) - How to use icons in releases, changelogs, and READMEs
+- [Release Icons Documentation](../RELEASE/RELEASE_ICONS.md) - How to use icons in releases, changelogs, and READMEs
 
 ## Notes
 

docs/example/badge-collection.md

@@ -0,0 +1,113 @@
+# GET /badge/collection
+
+Render multiple user badges into one SVG image.
+
+## Route
+
+- /badge/collection?username=pphatdev&type=visitors,total-stars,repositories
+
+## Required Query Params
+
+| Param | Description |
+|---|---|
+| username | GitHub username |
+| type | Comma-separated user badge types |
+
+Supported badge types:
+
+- visitors
+- repositories
+- organization
+- languages
+- followers
+- total-stars
+- total-contributors
+- total-commits
+- total-code-reviews
+- total-issues
+- total-pull-requests
+- total-joined-years
+
+## Optional Query Params
+
+| Param | Description |
+|---|---|
+| columns | Number of columns in the grid (default: 1, max: 10) |
+| gap | Gap between badges in pixels (default: 8, range: 0-100) |
+| theme | Badge theme |
+| customLabel | Custom label text (applies to all badges in the collection) |
+| labelColor | Label text color |
+| labelBackground | Label background color |
+| iconColor | Icon color |
+| valueColor | Value text color |
+| valueBackground | Value background color |
+
+## Basic Examples
+
+Two badges in one SVG:
+
+![badge-collection-basic](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars)
+
+Multiple badges with 3 columns:
+
+![badge-collection-columns](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,repositories,followers,total-stars,total-issues,total-pull-requests&columns=3)
+
+## Layout Examples
+
+Custom columns and gap:
+
+![badge-collection-layout](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,repositories,followers,total-stars,total-issues,total-pull-requests&columns=2&gap=12)
+
+Single-row layout:
+
+![badge-collection-row](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,repositories,followers,total-stars,total-issues,total-pull-requests&columns=6)
+
+## Style Examples
+
+Theme:
+
+![badge-collection-theme](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories&theme=ocean)
+
+Custom colors:
+
+![badge-collection-colors](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories&labelBackground=0d1117&labelColor=ffffff&valueBackground=1f2937&valueColor=22c55e)
+
+## Combined Example
+
+Theme + colors + columns + gap:
+
+![badge-collection-combined](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,repositories,followers,total-stars,total-issues,total-pull-requests&theme=tokyonight&columns=3&gap=10&labelBackground=0d1117&valueBackground=111827)
+
+## Curl Examples
+
+```bash
+curl "https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars"
+curl "https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,repositories,followers,total-stars&columns=2"
+curl "https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories&theme=ocean"
+```
+
+## Error Examples
+
+Missing username:
+
+```bash
+curl "https://stats.pphat.top/badge/collection?type=visitors,total-stars"
+```
+
+Missing type:
+
+```bash
+curl "https://stats.pphat.top/badge/collection?username=pphatdev"
+```
+
+Invalid type:
+
+```bash
+curl "https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,unknown-badge"
+```
+
+Invalid columns:
+
+```bash
+curl "https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars&columns=0"
+```

docs/how-to/README.md

@@ -14,7 +14,7 @@ This folder contains comprehensive guides on how to use each API route available
 - **[Project Badge Routes](./PROJECT_BADGES.md)** - Repository-specific badges (stars, forks, issues, etc.)
 
 ### 🎨 Icons & Visual Assets
-- **[Release Icons Documentation](./RELEASE_ICONS.md)** - Using icons in releases, changelogs, and READMEs
+- **[Release Icons Documentation](../RELEASE/RELEASE_ICONS.md)** - Using icons in releases, changelogs, and READMEs
 
 ### 🔧 Monitoring & Health
 - **[Cache Monitoring Guide](./CACHE_MONITORING.md)** - Health checks and cache statistics endpoints

package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-stats",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Generate dynamic GitHub stats cards for your README",
   "main": "dist/index.js",
   "type": "module",