https://github.com/nitingoley/leaderboard-mern
Budilg leaderboard ranking web app
https://github.com/nitingoley/leaderboard-mern
mongodb nodejs react tailwindcss
Last synced: 3 months ago
JSON representation
Budilg leaderboard ranking web app
- Host: GitHub
- URL: https://github.com/nitingoley/leaderboard-mern
- Owner: nitingoley
- Created: 2025-07-14T07:15:11.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-16T04:36:00.000Z (12 months ago)
- Last Synced: 2025-09-04T10:59:35.993Z (10 months ago)
- Topics: mongodb, nodejs, react, tailwindcss
- Language: JavaScript
- Homepage: https://leaderboard-odsv.onrender.com/
- Size: 3.56 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Leaderboard Application
The Leaderboard Application is a full-stack web project designed to manage and display user rankings based on points claimed over time. It consists of a robust backend API and an interactive frontend interface, enabling seamless user management, point claiming, leaderboard visualization, and claim history tracking.
## Overview
- **Backend:** Built with Node.js, Express, and MongoDB, the backend provides RESTful APIs for user operations, point claiming, leaderboard ranking, and history management.
- **Frontend:** Developed using modern web technologies (such as React), the frontend offers a user-friendly interface for interacting with the leaderboard system.
## Features
- **User Management:** Register new users and view the list of all users.
- **Point Claiming:** Users can claim random points, which are added to their total.
- **Leaderboard:** Displays users ranked by their total points in real-time.
- **Claim History:** Tracks and displays all point claims with timestamps for transparency.
## Technologies Used
- **Backend:** Node.js, Express.js, MongoDB, Mongoose, CORS, dotenv
- **Frontend:** React (or your chosen framework), Axios (for API requests), modern CSS
## Getting Started
### Prerequisites
- Node.js (v16+ recommended)
- npm
- MongoDB (local or Atlas)
### Installation
#### Backend
1. Navigate to the `Backend` directory:
```sh
cd Backend