🚀 samdev-pulse

A calm, modern GitHub profile dashboard — generated as a single SVG.

Drop one image into your README and get live GitHub stats, contribution activity, language breakdowns, and achievement trophies. No widgets. No clutter. It just works.

---

⚡ Quick Usage

Add this to your GitHub profile README (repo name = your username):

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=YOUR_GITHUB_USERNAME)

That’s it. Your profile now renders a live dashboard.

Live Example Preview

---

🎨 Customization Examples

Theme

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=YOUR_GITHUB_USERNAME&theme=tokyonight)

Available themes: dark (default), light, dracula, nord, tokyonight, monokai, gruvbox, solarized, catppuccin, rose-pine

---

LeetCode Stats (Optional)

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=YOUR_GITHUB_USERNAME&leetcode=YOUR_LEETCODE_USERNAME)

Disable LeetCode and show repository stats instead:

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=YOUR_GITHUB_USERNAME&leetcode=false)

---

Header Alignment

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=YOUR_GITHUB_USERNAME&align=center)

Options: left (default), center, right

---

Full Example

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=SamXop123&theme=tokyonight&leetcode=Dot_NotSam&align=center)

---

Why samdev-pulse?

• Designed as one cohesive SVG, not stitched widgets
• Calm, readable visuals that don’t overpower your profile
• Built for developers who care about craft, clarity, and signal over noise

---

✨ Features

📊 GitHub Activity

• Total contributions (year)
• Pull requests opened
• Issues opened
• Live data via GitHub REST API

🔥 Streak Statistics

• Current streak
• Longest streak
• Total contribution days
• Powered by GitHub GraphQL API

📈 Contribution Activity Graph

• SVG line chart (last 30 days)
• Auto-scaled Y-axis
• Smooth curves with gradient fill

🍩 Top Languages

• Donut chart (top 5 languages)
• Percentage-based slices
• Calculated from public repositories

💻 LeetCode Integration (Optional)

• Total problems solved
• Easy / Medium / Hard breakdown
• Contest rating with fallback to ranking

---

🏆 Achievement Trophies

A visual trophy system highlighting GitHub milestones:

Trophy	Description
💪 Commits	Total contributions
🔀 Pull Requests	PRs opened
🐛 Issues	Issues opened
📦 Repositories	Public repos
⭐ Stars	Total stars
👥 Followers	GitHub followers

📊 Trophy tier requirements

• 🥉 Bronze: Entry level (1+)
• 🥈 Silver: 100+ (500+ for stars)
• 🥇 Gold: 500+ (1000+ for stars)
• 💎 Diamond: 1000+ (5000+ for stars)

---

⚙️ Query Parameters

Parameter	Type	Default	Description
username	string	SamXop123	GitHub username
theme	string	dark	Visual theme
leetcode	string / false	–	LeetCode username or disable
align	string	left	Header alignment

---

🛠️ Local Development

Prerequisites

• Node.js 18+
• GitHub Personal Access Token

Setup

git clone https://github.com/SamXop123/samdev-pulse.git
cd samdev-pulse
npm install

Environment Variables

GITHUB_TOKEN=your_github_personal_access_token
DEFAULT_USERNAME=octocat
PORT=3000
NODE_ENV=development

Run

npm run dev

Visit:

http://localhost:3000/api/profile?username=octocat

---

🔍 API

GET /api/profile

Returns an SVG dashboard.

• Content-Type: image/svg+xml
• Cache-Control: public, max-age=1800

GET /health

Health check endpoint.

---

📁 Project Structure

src/
├── routes/        # API routes
├── services/      # GitHub & LeetCode APIs
├── renderers/     # SVG layout & charts
├── themes/        # Theme definitions
└── utils/         # Caching & helpers

---

🔒 Usage & privacy

samdev-pulse logs basic, non-sensitive usage information (such as the github username passed to the api) for monitoring and improving the service.

no personal data, authentication details, or private information is collected.

---

🤝 Contributing

Contributions are welcome. Please see CONTRIBUTING.md for guidelines.

Ideas:

• More themes
• Codeforces / CodeChef support
• New trophy categories
• Animated SVG elements
• CI & tests

---

📝 License

MIT © SamXop123

---

⭐ Support

If this helped you, consider giving the repo a ⭐ It helps more developers discover the project.

---