Empowering Ugandan Chess Excellence through a Professional Digital Ecosystem.
ChessFed Uganda is the official high-fidelity digital hub designed for the Uganda Chess Federation. It serves as a comprehensive platform for tournament discovery, national rankings, Grand Prix tracking, and professional federation operations.
| Landing Page | National Rankings |
|---|---|
 |
 |
| Grand Prix Standings | Member Dashboard |
|---|---|
 |
 |
The platform features a modern, eye-soothing dark aesthetic (Zinc-950) that harmonizes the Official Federation Blue with the vibrant National Flag Colors (Black, Yellow, Red). Every view is optimized for spatial efficiency and visual prestige.
- Dynamic Tournament Calendar: Browse the official 2026 season with real-time status indicators.
- Event Portals: Dedicated high-impact pages for major championships featuring prize funds, history, and partner spotlights.
- Grand Prix Engine: A real-time cumulative leaderboard tracking the race for the National Team.
- National Rankings: Official Top 100 ELO rankings updated monthly from FIDE records.
- Clubs & League Directory: Comprehensive roster and standings for 20+ official Ugandan chess clubs.
- Verified Identity Linking: Securely link physical FIDE/National IDs to digital accounts.
- Player Dashboard: Personal performance hub showing ELO history and upcoming registered events.
- Professional Onboarding: Modern, validated Sign-In and Registration flows powered by
React Hook FormandZod. - Tournament Entry: Streamlined registration flow with deadline validation and fee transparency.
- Oversight Console: Central command for federation officials to track participation and growth.
- Event Management: Tools to initialize tournaments and broadcast Grand Prix points directly to the public standings.
- Club Management: Captain-level access to manage 12-man team rosters and lock league line-ups.
- Framework: Next.js 16 (App Router with Turbopack)
- Language: TypeScript
- Styling: Tailwind CSS v4 (Modern High-Fidelity)
- ORM: Prisma (PostgreSQL support, pooled serverless adapter wrapper)
- Database: Live Supabase PostgreSQL database
- FIDE Synchronization: Custom streaming SAX parser for direct monthly FIDE rating updates
- Authentication: NextAuth.js
- Forms: React Hook Form + Resolver Zod
- Node.js 18.x or later
- npm / bun / yarn
-
Clone the repository:
git clone https://github.com/AskTiba/ChessFed-Ug.git cd ChessFed-Ug -
Install dependencies:
npm install
-
Database Setup: Configure your Supabase connection strings inside
.envandprisma.config.ts, then run:npx prisma db push npx prisma db seed
-
Run the development server:
npm run dev
Open http://localhost:3000 to see the platform in action.
The platform is fully functional. Some specific routes for testing:
- Main Hub:
/ - Leaderboards:
/grand-prix|/rankings - Admin Access:
/admin(Manage manual syncs and tournament parameters) - Member Portal:
/dashboard(Login asadmin@chessfed.ug/password123)
- Phase 1: Public Awareness Hub (Calendar, Rankings, Portals)
- Phase 2: Functional Simulation MVP (Server Actions, Mock Store)
- Phase 3: High-Fidelity UI/UX Polish (National Pride Theme & Sleek Skeleton loaders)
- Phase 4: Live Production Backend (Supabase PostgreSQL, Prisma Client connection pooling, FIDE bulk data sync)
- Phase 5: Socket.io Live Games & Real-time Live Pairings
We ❤️ Open Source! This project is an open-source initiative dedicated to improving the digital infrastructure of Ugandan chess. We warmly welcome contributions from the community.
- Fork the repository.
- Create a feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
This project is currently the official digital development effort for the Uganda Chess Federation Community.
Built with passion by Anthony Tibamwenda.
© 2026 Uganda Chess Federation. All Rights Reserved.