Kick It is a dynamic sports event platform where players and organizers meet.
A full-stack web app for sports enthusiasts to create, discover, and join local games — whether you’re looking for a casual pickup match or a competitive tournament, Kick It brings athletes together seamlessly.
| Page | Preview |
|---|---|
| 🏠 Home Page |  |
| 📅 Event Page |  |
| 👤 Profile Page |  |
- 🔐 User Auth & Profiles – Secure JWT-based login with OAuth support.
- 📅 Event Creation & Discovery – Schedule, browse, and join games nearby.
- 💬 Real-Time Chat – Dedicated group chats for event participants.
- 🔔 Live Notifications – Instant updates for event changes, messages, and invites.
- ⭐ Review & Rating System – Rate players and organizers to build trust.
- 📊 Performance Analytics – Track player stats and match history.
- React.js – Component-based UI
- Tailwind CSS – Utility-first responsive styling
- Node.js + Express.js – RESTful API & server logic
- MongoDB (Mongoose) – NoSQL database for users, events, and chat
- Socket.IO – Live chat & instant event updates
- JWT – Secure token-based sessions
- OAuth 2.0 – Login with Google or other providers
Clone the repository:
git clone https://github.com/yourusername/kickit.git
cd kickit
Backend Setup
bash
Copy code
cd server
npm install
Create a .env file and add:
env
Copy code
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
OAUTH_CLIENT_ID=your_oauth_client_id
OAUTH_CLIENT_SECRET=your_oauth_client_secret
Run the backend:
bash
Copy code
npm run dev
Frontend Setup
bash
Copy code
cd client
npm install
npm run dev
The app should now be running locally 🎉
🌍 Why Kick It?
🤝 Build a Sports Community – Connect with local players.
🗓️ Never Miss a Game – Easy scheduling & reminders.
💬 Stay Engaged – Chat, review, and track performance in one place.
💻 Contribute
We welcome contributions from the community!
Check out our CONTRIBUTING.md to get started.
🎯 Why This Stands Out
✅ Modern Tech Stack – Real-time features and analytics.
✅ Open-Source Friendly – Easy to contribute and extend.
✅ Professional + Fun – Clean structure with lively presentation.
📄 License
This project is licensed under the MIT License – see the LICENSE file for details.
yaml
Copy code
---
Would you like me to **add badges** (for tech stack, license, contributors, etc.) at the top?
They make the README look more polished on GitHub.