KickHub User Guide
The all-in-one platform for community football clubs. Everything you need to manage teams, schedules, players, and more — in one beautiful hub.
System Architecture
KickHub uses a modern, decoupled architecture with three main components connected through a RESTful API.
Landing Page
The marketing site is the first thing visitors see. It features 6 switchable premium layouts inspired by top sports brands.
Available Layouts
Authentication
Login
Navigate to /auth/login or click Sign In from the landing page. Enter your email and password to access your dashboard.
Registration
Navigate to /auth/register or click Get Started. Registration takes under 60 seconds:
Dashboard Overview
After logging in, you land on the dashboard — the command center for your club.
Sidebar Navigation
| Section | Pages |
|---|---|
| Overview | Dashboard, Schedule, Messages, Family Hub |
| Club Management | Teams & Rosters, Registration, Smart Carpool, Live Match |
| Development | AI CoachBot, Player Profiles, Highlight Clips, Weather |
| Club | Super Admin, Theme Customizer, Settings |
Schedule
Comprehensive calendar view of all club events — practices, games, tournaments, meetings, and fundraisers. Filter by team, event type, or date range. Supports day, week, and month views.
Messages
Real-time messaging hub for team communication. Create team chats, direct messages, and announcement channels. Group conversations by team or topic.
Teams & Rosters
Manage all your club's teams — view rosters, player details, jersey numbers, and positions. Create new teams, assign coaches, and manage player transfers between teams.
Family Hub
Designed for parents with multiple kids in the club. See all children's schedules, stats, badges, payments, and upcoming events consolidated in one view.
Live Match
Broadcast-style match tracking with real-time scores, player stats, timeline events, and formation views. Responsive layout works on desktop and mobile.
Player Profiles
Detailed player cards with stats, skill ratings, training progress, badges, evaluations, and development history. Each profile includes physical measurements, preferred foot, and emergency contacts.
Highlight Clips
Video highlight manager — upload, tag, and share player highlight clips. Create recruitment portfolios for college scouts. Tag clips by player, event, and skill category.
AI CoachBot
AI-powered coaching assistant that provides:
Super Admin Panel
The Platform Command Center — accessible only to admins. Full control over users, clubs, and platform operations.
Theme Customizer
Customize the look and feel of the entire platform. Switch between preset themes or create custom brand colors for premium club accounts.
Mobile App
The Expo/React Native mobile app provides on-the-go access with 3 main tabs:
expo-secure-store.User Roles & Permissions
Deployment
Running Locally
Production
| Service | Platform | How |
|---|---|---|
| Web App | Vercel | Auto-deploys on git push |
| API | Render | Connect repo → detects render.yaml |
| Mobile | EAS Build | eas build --profile production |
| Database | Neon | Already hosted (free tier) |
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/health | GET | Health check |
/api/v1/auth/login | POST | Login (returns JWT) |
/api/v1/auth/register | POST | Register new user |
/api/v1/auth/me | GET | Current user profile |
/api/v1/clubs | GET | List all clubs |
/api/v1/teams | GET | List teams |
/api/v1/events/upcoming | GET | Upcoming events |
/docs | GET | Swagger API docs |
Test Accounts
password123. For production, use strong passwords and rotate JWT_SECRET.| Role | Club | |
|---|---|---|
admin@test.com | Platform Admin | All |
jamie@thunderfc.com | Club Admin | Thunder FC |
rachel@riversideunited.com | Club Admin | Riverside United |
carlos@valleystars.com | Club Admin | Valley Stars |
coach.williams@thunderfc.com | Coach | Thunder FC |
coach.patel@riversideunited.com | Coach | Riverside United |
sarah.kim@email.com | Parent | Thunder FC |
marcus.johnson@email.com | Parent | Thunder FC |
alex.kim@email.com | Player | Thunder FC |
volunteer.anna@email.com | Volunteer | Thunder FC |
Built with ❤️ by the KickHub team