Transform your GitHub profile into a canvas for beautiful contribution art
Gitgenix is a powerful, intuitive web application that lets you create stunning pixel art on your GitHub contribution graph. Design patterns, text, shapes, and complex artwork that appears on your GitHub profile, making your coding journey more visually expressive and creative.
- Developers who want to personalize their GitHub profiles
- Creative Coders looking to combine art with programming
- Job Seekers who want their profiles to stand out
- Students learning about Git and GitHub
- Anyone who loves pixel art and wants to have fun with their GitHub activity
- 🌐 Visit: gitgenix.netlify.app
- 🎨 Design: Create your pattern using the visual editor
- ⚙️ Configure: Set your GitHub repository details
- 📥 Generate: Download your custom shell script
- 🏃 Execute: Run the script and watch your art appear!
New to Gitgenix? Check out our Quick Start Guide for a detailed walkthrough!
- Intuitive Interface: Click-and-drag grid with 5 intensity levels
- Real-time Preview: See exactly how your pattern will appear on GitHub
- Mobile Optimized: Full touch support for tablets and phones
- Smooth Animations: Buttery-smooth interactions with Framer Motion
- Custom Limits: Set minimum (0-100) and maximum (1-1000) daily contributions
- Intelligent Scaling: Automatic intensity distribution between your limits
- Profile Matching: Blend your art naturally with existing GitHub activity
- Flexible Patterns: Create subtle designs or bold, high-contrast artwork
- Auto-Repository Detection: Smart detection of existing repositories
- GitHub CLI Integration: Seamless repository creation with
ghcommand - Cross-Platform Scripts: Generated for Windows (PowerShell), macOS, and Linux
- Error Handling: Built-in validation and fallback mechanisms
- Beautiful Share Pages: Optimized UI for sharing your creations
- JSON Export/Import: Full pattern backup with metadata
- Social Media Ready: Rich preview cards for social sharing
- Community Gallery: Browse and share patterns with other creators
- Expansive Artwork: Create patterns spanning multiple years
- Cross-Year Copying: Duplicate patterns across different years
- Timeline Planning: Strategic placement for maximum visibility
- Complex Animations: Build time-based visual narratives
- Lightning Fast: Optimized rendering for complex patterns
- Responsive Design: Works perfectly on all device sizes
- Reduced Motion: Respects user accessibility preferences
| Frontend | Backend | Development | Deployment |
|---|---|---|---|
| Next.js 15 | Firebase Firestore | TypeScript 5 | Netlify |
| React 19 | GitHub API | ESLint | Automatic Builds |
| Tailwind CSS 3 | Node.js | Prettier | CDN |
| Framer Motion | - | VS Code | Analytics |
- Modern React: Latest React 19 with concurrent features
- Type Safety: Full TypeScript coverage for reliability
- Performance First: Optimized animations and lazy loading
- SEO Optimized: Complete sitemap and metadata
- PWA Ready: Progressive Web App capabilities
| Guide | Description | Best For |
|---|---|---|
| 🚀 Quick Start | 5-minute setup guide | New users |
| 📖 User Guide | Comprehensive instructions | All users |
| ❓ FAQ | Common questions & troubleshooting | Problem solving |
| Guide | Description | Best For |
|---|---|---|
| 🤝 Contributing | How to contribute code | Contributors |
| 🔧 Development | Local setup & development | Developers |
| 📚 Developer Reference | API docs & architecture | Advanced developers |
| 🚀 Deployment | Production deployment | DevOps |
We ❤️ contributions! Gitgenix is built by the community, for the community.
- 🐛 Report Bugs: Help us identify and fix issues
- ✨ Suggest Features: Share your ideas for improvements
- 📝 Improve Docs: Help others understand Gitgenix better
- 💻 Write Code: Implement features and fix bugs
- 🎨 Design: Enhance UI/UX and accessibility
- 🧪 Test: Improve quality and reliability
# 1. Fork the repository on GitHub
# 2. Clone your fork
git clone https://github.com/thesujalpatel/gitgenix.git
# 3. Create a feature branch
git checkout -b feature/amazing-feature
# 4. Make your changes and commit
git commit -m 'feat: add amazing feature'
# 5. Push and create a Pull Request
git push origin feature/amazing-featureFirst time contributing? Look for issues labeled good first issue
Need help? Check our Contributing Guide or ask in Discussions
Thanks to all the amazing people who make Gitgenix better!
If Gitgenix helps you create amazing GitHub art:
- ⭐ Star this repository to show your appreciation
- 🐛 Report bugs to help improve the app
- 🎨 Share your creations on social media with
#Gitgenix - 🤝 Contribute code to make it even better
- 💝 Spread the word to other developers
Gitgenix includes a simple session-based analytics system to track user engagement and provide usage statistics. This helps us improve the application and understand how users interact with it.
- 📈 Session Analytics: Track unique visitors and sessions using localStorage
- 🔒 Privacy-Focused: All tracking is done locally without external services
- 🛠️ Simple Setup: No configuration required - works out of the box
- 📊 Real-time Stats: View live statistics in the admin dashboard
- Unique Visitors: Tracked using browser localStorage, persisted across sessions
- Session Tracking: 30-minute session windows for active usage tracking
- Happy Developers: Calculated automatically based on visitor activity and pattern creation
- Local Caching: Stats are cached locally for better performance
- Session-based visitor tracking
- Real-time stats dashboard
- Automatic happy developer calculation
- Local storage for privacy
- No external dependencies
- 🐛 Bug Reports: GitHub Issues
- 💭 Questions & Ideas: GitHub Discussions
- 📖 Documentation: Complete User Guide
- 🚀 Quick Help: 5-Minute Setup Guide
- GitHub: @thesujalpatel
- Website: gitgenix.netlify.app
- Discussions: Community Forum
This project is licensed under the MIT License - see the LICENSE file for details.
- ✅ Commercial use: Use in commercial projects
- ✅ Modification: Change and adapt the code
- ✅ Distribution: Share your modified versions
- ✅ Private use: Use for personal projects
- ❗ License notice: Include the original license
Transform your GitHub profile today!
Built with ❤️ by Sujal Patel and the amazing community
Making GitHub profiles more expressive, one pixel at a time.
🎯 Try Now • 📖 Learn More • 🤝 Contribute • 💬 Discuss
Star ⭐ this repository if you found it helpful!