🚀 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 :

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

YOUR_GITHUB_USERNAME : change this to 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, aurora, midnight-sunset, onedarkpro, material, synthwave84, forestnight, oceanicnext, emberglow, midnightneon, pasteldream

---

✨ Newly Added Themes

Theme	Description
One Dark Pro	VS Code inspired modern editor palette
Material	Material UI inspired clean modern tones
Synthwave 84	Retro neon cyberpunk aesthetics
Forest Night	Deep green nature-inspired palette
Oceanic Next	Cool ocean blues with coding vibes
Ember Glow	Warm fiery orange and crimson tones
Midnight Neon	Futuristic glowing cyber aesthetics
Pastel Dream	Soft dreamy pastel gradients and tones

---

💻 Competitive Programming Stats (Optional)

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

Depending on how many platforms you provide:

• 1 platform: Replaces the default repository stats card.
• 2+ platforms: Renders a dedicated "Competitive Programming" section at the bottom for a clean layout.
• 0 platforms: Shows the default repository stats card.

---

📍 Header Alignment

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

Options:

• left (default)
• center
• right

---

🏆 Hide Trophies (Optional)

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

---

🌟 Full Example

![samdev-pulse](https://samdev-pulse.vercel.app/api/profile?username=SamXop123&theme=synthwave84&align=center&leetcode=fjzzq2002&codeforces=tourist&codechef=tourist)

Preview

---

❓ 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

---

💻 Competitive Programming (Optional)

• LeetCode: Total problems solved, difficulty breakdown, contest rating
• Codeforces: Current rating, max rating, rank
• CodeChef: Current rating, max rating, stars
• Adaptive Layout: Automatically organizes 1 or multiple platform stats cleanly

---

🎨 Extensive Theme Support

• 20+ handcrafted dashboard themes
• Modern dark, pastel, neon, and nature-inspired palettes
• Consistent SVG rendering across charts and trophies
• Optimized text contrast and readability

---

🏆 Achievement Trophies

A visual trophy system highlighting GitHub milestones:

Trophy	Description
💪 Commits	Total contributions
🔀 Pull Requests	PRs opened
👁️ Reviews	PR reviews
🐛 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 (20+ supported themes)
leetcode	string / false	–	LeetCode username
codeforces	string / false	–	Codeforces username
codechef	string / false	–	CodeChef username
align	string	left	Header alignment
hide_trophies	boolean	false	Hide the achievements trophies row

---

🛠️ 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

Create a .env file:

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

---

Run

npm run dev

Visit:

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

---

🔍 API

GET /api/profile

Returns an SVG dashboard.

Response Headers

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

---

GET /health

Health check endpoint.

---

📁 Project Structure

src/
├── routes/        # API routes
├── services/      # GitHub & platform 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
• 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.