The most comprehensive and visually stunning Hacktoberfest progress tracker for 2025!
Track your journey to complete Hacktoberfest 2025 by making 6 valid pull requests during October and earn your digital badges as a Super Contributor! Our checker validates PRs according to the latest Hacktoberfest 2025 guidelines.
🚀 Check Your Progress: gitfork.netlify.app
- 6 PR Requirement: Updated from 4 to 6 valid pull requests
- Digital Badges: New reward system with evolving digital badges
- Super Contributor Status: Recognition for completed participants
- October 1-31 Timeframe: Precise date validation for 2025
- Official Hacktoberfest 2025 Theme: Matching colors and branding
- Modern UI/UX: Glass morphism, gradients, and smooth animations
- Enhanced Progress Tracking: Dynamic color-coded circular progress bars
- Mobile-First Design: Optimized for all devices and screen sizes
- Accessibility Improvements: Better contrast and keyboard navigation
- React 18.3+: Latest React features and performance improvements
- Material-UI v7: Modern component library with enhanced theming
- Bootstrap 5.3+: Updated responsive framework
- Enhanced API Integration: Improved GitHub API handling and error management
- TypeScript Ready: Better type safety and developer experience
Modern, vibrant design with official Hacktoberfest 2025 branding
While other checkers exist, our 2025 version stands out because:
- 🎯 Always Up-to-Date: Reflects the latest Hacktoberfest 2025 guidelines
- 🎨 Official Branding: Matches the official Hacktoberfest visual identity
- 📱 Mobile-First: Optimized for developers on the go
- ⚡ Real-Time Validation: Instant PR validation with detailed feedback
- 🚀 Modern Tech Stack: Built with the latest web technologies
- 6 Valid PRs: Increased from 4 to 6 pull requests
- Opt-in Only: Projects must explicitly participate in Hacktoberfest
- Quality Focus: Enhanced validation for meaningful contributions
- Digital Rewards: New badge system replacing physical rewards
Your pull request counts toward Hacktoberfest 2025 completion only when ALL of these conditions are met:
- ✅ Submitted during October 1-31, 2025
- ✅ Created within the official Hacktoberfest timeframe
- ✅ Submitted to a public repository
- ✅ Repository has the
hacktoberfesttopic OR - ✅ PR is labeled
hacktoberfest-acceptedby a maintainer
- ✅ PR is merged OR approved by maintainers
- ✅ PR is not marked as spam or invalid
- ✅ Repository is not excluded from Hacktoberfest
- Node.js: v18.0.0+ (LTS recommended)
- React: 18.3+
- Browser: Modern browser with ES2020+ support
- Memory: 512MB+ available RAM
Before running locally, check your GitHub API rate limit.
Recommended: Generate a GitHub Personal Access Token to increase rate limits.
# Clone the repository
git clone https://github.com/genialkartik/hacktoberfest-checker.git
# Navigate to project directory
cd hacktoberfest-checker
# Install dependencies
npm install
# Start development server
npm start
# Open in browser
open http://localhost:3000Create a .env file in the root directory:
REACT_APP_GITHUB_API=https://api.github.com/search/issues
REACT_APP_HEADER_AUTHORIZATION=token YOUR_GITHUB_TOKENnpm start # Start development server
npm test # Run test suite
npm run build # Create production build
npm run lint # Run ESLint checks
npm run format # Format code with PrettierWe welcome contributions from the community! Here's how you can help make the Hacktoberfest Checker even better:
Found a bug or have a feature request? Open an issue with detailed information.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow the existing code style and conventions
- Write clear, descriptive commit messages
- Add tests for new features when applicable
- Update documentation as needed
- Ensure all tests pass before submitting
Look for issues labeled good first issue if you're new to the project.
src/
├── components/ # React components
│ ├── Blog/ # Blog and documentation
│ ├── assets/ # Images, styles, and static files
│ └── footer/ # Footer component
├── api/ # GitHub API integration
├── routes/ # Application routing
└── styles/ # Global styles and themes
- Real-time PR validation with GitHub API
- Progressive Web App capabilities
- Responsive design for all devices
- Dark theme with modern aesthetics
- Error handling with user-friendly messages
- Performance optimized with code splitting
npm test # Run all tests
npm run test:watch # Run tests in watch mode
npm run test:coverage # Generate coverage reportThe 2025 update includes a comprehensive design system:
- Color Palette: Official Hacktoberfest 2025 colors
- Typography: Inter and JetBrains Mono fonts
- Components: Reusable UI components with consistent styling
- Animations: Smooth transitions and micro-interactions
- Lighthouse Score: 95+ across all metrics
- Core Web Vitals: Optimized for excellent user experience
- SEO Optimized: Proper meta tags and structured data
- Accessibility: WCAG 2.1 AA compliant
- Kartik Tyagi - Creator & Maintainer
- All Contributors - Community Heroes
- DigitalOcean - For organizing Hacktoberfest
- GitHub - For providing excellent APIs
- React Community - For the amazing ecosystem
- Open Source Contributors - For making this possible
This project is licensed under the MIT License - see the LICENSE file for details.
MIT © 2025 Kartik Tyagi
- Live Demo: gitfork.netlify.app
- GitHub Repository: genialkartik/hacktoberfest-checker
- Issues: Report bugs or request features
- Discussions: Join the community
- Official Hacktoberfest: hacktoberfest.com
Made with ❤️ for the Open Source Community
Star ⭐ this repository if it helped you track your Hacktoberfest progress!
