🕹️ GAMIFY — Turn Any Goal into a Game

Click here to learn more about the project.

• 🆓 Free & Open-Source — MIT licensed and community-driven
• 🛠️ Fully Self-Hostable — Complete control over your data and deployment
• 🌍 Multi-Platform — Web dashboard and Discord integration
• 🧱 Modular Architecture — Easy to customize and extend
• 🎮 Gamify Anything — From study groups to corporate teams
• 🧑‍🤝‍🧑 Built for Teams & Communities — Role-based collaboration baked in

Landing Page

Login Page

Dashboard

Register Page.

• 🎯 Event Creation — Define your own events, tasks, and currency system
• 👥 Role-Based Permissions — Owners, Admins, Moderators, Members
• ✅ Task Management — Admins create tasks, moderators verify them
• 🎁 Reward Store — Members redeem points for real or virtual rewards
• 🖥️ Web Dashboard — Full-featured dashboard for managing events
• 🤖 Discord Bot — Seamless interaction with Discord for members

client/
├─ public/
│ └─ vite.svg
├─ src/
│ ├─ components/
│ │ ├─ Footer.jsx
│ │ ├─ Home.jsx
│ │ ├─ Navbar.jsx
│ │ └─ ScrollToTop.jsx
│ ├─ Context/
│ │ └─ AuthContext.jsx
│ ├─ pages/
│ │ ├─ About.jsx
│ │ ├─ AuthForms.jsx
│ │ ├─ Contact.jsx
│ │ ├─ Dashboard.jsx
│ │ └─ Profile.jsx
│ ├─ routes/
│ │ └─ ProtectedRoute.jsx
│ ├─ App.jsx
│ ├─ index.css
│ └─ main.jsx
└─ Additional Documentation

server/
├─ config/
│ └─ db.js
├─ controllers/
│ ├─ authController.js
│ └─ userController.js
├─ middlewares/
│ └─ authMiddleware.js
├─ models/
│ └─ User.js
├─ routes/
│ ├─ authRoutes.js
│ └─ userRoutes.js
└─ Additional Documentation

• Node.js (v16+)
• MongoDB (Atlas or local)
• A Discord Bot Token (Get one here)

git clone https://github.com/DeadIndian/Gamify.git
cd gamify

cd client && npm install
cd ../server && npm install
cd ../bot && npm install

Create .env files in client/, server/, and bot/ directories.

PORT=5000
MONGO_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret
FRONTEND_URL=your_frontend_url
EMAIL_USERNAME=your_email
EMAIL_PASSWORD=your_password
# Rate limiting for authentication endpoints
AUTH_LOGIN_MAX=10
AUTH_LOGIN_WINDOW_MS=900000
AUTH_REGISTER_MAX=5
AUTH_REGISTER_WINDOW_MS=3600000

The server includes rate limiting for authentication endpoints to prevent abuse:

• Login Protection: AUTH_LOGIN_MAX attempts per AUTH_LOGIN_WINDOW_MS milliseconds (default: 10 per 15 minutes)
• Registration Protection: AUTH_REGISTER_MAX attempts per AUTH_REGISTER_WINDOW_MS milliseconds (default: 5 per hour)

When limits are exceeded, endpoints return:

{
 "success": false,
 "message": "Too many login attempts. Try again later."
}

DISCORD_TOKEN=your_discord_bot_token
GUILD_ID=your_guild_id
API_URL=http://localhost:5000

# Terminal 1 (For Backend)
cd server && npm run dev
# Terminal 2 (For Frontend)
cd client && npm run dev
# Terminal 3 (For Bot)
cd bot && node index.js

Ready to deploy Gamify? We have detailed deployment guides to help you:

💡 New to deployment? Start with the General Deployment Guide.

We love contributions from the community! To contribute:

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -m 'Add some feature')
4. Push to the branch (git push origin feature/your-feature)
5. Open a Pull Request

For major changes, please open an issue first to discuss what you’d like to change.

We are grateful to all the amazing contributors who have helped make this project better! 🌟

This project is licensed under the MIT License.