A beautiful, automated GitHub Actions dashboard that tracks your coding consistency and builds lasting habits. Features real-time activity heatmaps, streak tracking, and colorful visualizations - all updating automatically for years without maintenance.
- 🎨 Beautiful Dashboard - Colorful gradients, smooth animations, mobile-responsive design
- 📊 Activity Heatmap - 90-day GitHub-style contribution graph with proper color coding
- 🔥 Streak Tracking - Current streak, best streak, total commits, and success rate
- 🤖 Fully Automated - Daily commits at 2:00 AM UTC + automatic dashboard updates
- 🌐 GitHub Pages Ready - Zero-config deployment with intelligent data loading
- 📱 Mobile Optimized - Responsive design that works perfectly on all devices
- 🛠️ Self-Healing - Error recovery, data validation, and automatic maintenance
- ⚡ Lightning Fast - Loads in milliseconds with optimized performance
- GitHub account
- Public repository (or GitHub Pro for private repositories)
-
Fork or clone this repository
git clone https://github.com/yourusername/gitpulse-dashboard.git cd gitpulse-dashboard -
Enable GitHub Pages
- Go to repository Settings → Pages
- Set Source to "GitHub Actions"
-
Configure workflow permissions
- Go to Settings → Actions → General
- Select "Read and write permissions"
- Enable "Allow GitHub Actions to create and approve pull requests"
-
Deploy
git push origin main
Your dashboard will be live at: https://[username].github.io/[repository-name]
| Metric | Description | Visual |
|---|---|---|
| Current Streak | Days of consecutive commits | Orange gradient card |
| Total Commits | All automated commits | Green gradient card |
| Best Streak | Longest consecutive period | Purple gradient card |
| Success Rate | Percentage of active days | Pink gradient card |
- Heatmap Display: 90 days (desktop) / 42 days (mobile)
- Color Coding: GitHub-style green progression
- Interactive Elements: Hover tooltips with date details
- Responsive Design: Adapts to all screen sizes
- Production: Loads from log files via GitHub API
- Development: Uses Python server endpoints
- Fallback: Demo data for testing environments
- Frontend: Vanilla JavaScript, CSS Grid/Flexbox, SVG graphics
- Backend: GitHub Actions, Python (development)
- Storage: File-based logs in Git repository
- Hosting: GitHub Pages with automatic deployment
graph LR
A[Daily Cron] --> B[Update Logs]
B --> C[Git Commit]
C --> D[Deploy Pages]
D --> E[Dashboard Update]
- Trigger: Daily cron job at 2:00 AM UTC
- Process: Update activity logs and streak counters
- Commit: Atomic commit with retry logic
- Deploy: Automatic GitHub Pages deployment
- Update: Dashboard reflects new data immediately
- Error Recovery: Automatic retry logic for failed operations
- Data Validation: Streak count validation with auto-reset
- Size Management: Log rotation (keeps last 1000 entries)
- Timeout Protection: 10-minute workflow timeout prevents hanging
- GitHub Actions: <3% of free tier quota (60 minutes/month)
- Storage: ~365 KB growth per year
- Dependencies: Zero external APIs or services
- Maintenance: Completely automated operation
- View workflow status in repository Actions tab
- Dashboard displays real-time operational status
- Optional email notifications for failures
- Complete audit trail in Git history
├── index.html # Main dashboard page
├── dashboard.css # Styles and animations
├── dashboard.js # Interactive functionality
├── server.py # Local development server
├── _config.yml # GitHub Pages configuration
├── .github/
│ └── workflows/
│ └── daily-commit.yml # Automation workflow
├── logs/ # Auto-generated data
│ ├── daily-activity.log # Activity history
│ ├── streak-count.txt # Current streak
│ └── last-update.txt # Latest timestamp
├── docs/ # Documentation
│ ├── DEPLOYMENT.md
│ ├── LONG_TERM_MAINTENANCE.md
│ └── setup-github-pages.md
└── README.md # This file
Modify the workflow trigger in .github/workflows/daily-commit.yml:
on:
schedule:
- cron: '0 2 * * *' # Daily at 2:00 AM UTCCommon schedules:
'0 6 * * *'- 6:00 AM UTC daily'0 12 * * 1-5'- Noon UTC on weekdays'30 0 * * *'- 12:30 AM UTC daily
| Component | File | Purpose |
|---|---|---|
| Colors/Themes | dashboard.css |
Gradient colors, animations |
| Content | index.html |
Titles, labels, footer |
| Data Processing | dashboard.js |
Metrics calculation |
| Workflow Logic | daily-commit.yml |
Automation behavior |
git clone https://github.com/yourusername/gitpulse-dashboard.git
cd gitpulse-dashboard
python server.pyDashboard will be available at http://localhost:5000
- Manual Trigger: Use "Run workflow" button in Actions tab
- Validation: Check logs directory for generated files
- Dashboard: Verify metrics display correctly
| Issue | Solution |
|---|---|
| Dashboard not loading data | Verify GitHub Pages source is "GitHub Actions" |
| Workflow failing | Check "Read and write" permissions in Actions settings |
| Missing log files | Ensure workflow has repository write access |
| Incorrect metrics | Manually trigger workflow to reset data |
- Permission errors: Enable "Read and write permissions" in repository settings
- Branch protection: Ensure workflow can commit to main branch
- GitHub Pages: Must be enabled with "GitHub Actions" source
For detailed troubleshooting, see LONG_TERM_MAINTENANCE.md
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with GitHub Actions and GitHub Pages
- Inspired by GitHub's contribution graph
- Designed for long-term automated operation
Set it up once, enjoy forever!
🚀 Deploy to GitHub Pages • 📖 Documentation • 🛠️ Maintenance Guide