https://github.com/asqit/github-languages-widget
HTTP service for generating stats. for github profile
https://github.com/asqit/github-languages-widget
github golang http
Last synced: 3 months ago
JSON representation
HTTP service for generating stats. for github profile
- Host: GitHub
- URL: https://github.com/asqit/github-languages-widget
- Owner: Asqit
- Created: 2024-04-05T13:54:14.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-20T12:35:22.000Z (over 1 year ago)
- Last Synced: 2025-01-19T05:55:17.827Z (about 1 year ago)
- Topics: github, golang, http
- Language: Go
- Homepage: https://github-languages-widget.onrender.com/
- Size: 31.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GitHub Languages Widget
A Deno web service that generates a dynamic SVG widget showing the top programming languages used in a GitHub user's public repositories. Perfect for embedding in your GitHub README or personal website to showcase your coding profile.
---
## Features
- **SVG Widget Generation:** Returns an SVG image visualizing the top languages for any GitHub username.
- **Customizable Appearance:** Change the text color via query parameters.
- **Live Data:** Fetches language statistics directly from the GitHub API.
- **Health Endpoint:** `/health` route for service status checks.
- **Modern Stack:** Built with [Deno](https://deno.com/) and [Hono](https://hono.dev/) for fast, serverless deployment.
---
## Usage
Embed the widget in your README or website using an image tag:
```markdown
```
- Replace `YOUR_GITHUB_USERNAME` with your GitHub username.
- Optionally, set `color` to customize the text color (e.g., `color=%23000000` for black).
### Example
```markdown
```
---
## API Endpoints
- `/`
**GET**: Returns the SVG widget.
**Query Parameters:**
- `username` (required): GitHub username
- `color` (optional): Text color (hex or named)
- `/health`
**GET**: Returns service health status.
---
## How It Works
1. Receives a request with a GitHub username.
2. Fetches public repositories and their language stats from the GitHub API.
3. Calculates the top languages by percentage.
4. Generates and returns an SVG image visualizing the results.
---
## Tech Stack
- **Deno**: Secure runtime for JavaScript and TypeScript.
- **Hono**: Lightweight web framework for building APIs.
- **GitHub REST API**: For fetching repository and language data.
---
## License
MIT
---
## Author
[asqit](https://github.com/asqit)