Online Auction System

This is a modern and user-friendly online auction platform where users can bid on various products. The system is built using React for the frontend, Express for the backend, and MongoDB for the database. The project supports real-time bidding, user authentication, and a countdown timer for each auction. The platform features an intuitive UI with a clean, responsive design and smooth animations for an enhanced user experience.

Table of Contents

• Features
• Installation
• Usage
• Project Structure
• Contributing
• License

Features

• User authentication and authorization
• Real-time bidding with live updates
• Countdown timer for auctions
• Product categories and search functionality
• Responsive and modern UI/UX
• Smooth animations and interactive elements

Installation

Prerequisites

• Node.js (v14.x or higher)
• MongoDB (v4.x or higher)

Steps

1. Clone the repository:

   git clone https://github.com/amitrajstm/online-auction-system.git

2. Navigate to the project directory:

   cd online-auction-system

3. Install dependencies for the backend:

   cd server
   npm install

4. Install dependencies for the frontend:

   cd ../client
   npm install

5. Start the MongoDB server and configure the environment variables.
6. Run the backend server:

   cd server
   node index.js

7. Run the frontend development server:

   cd ../client
   npm run dev

Usage

• Once the servers are running, open your browser and navigate to http://localhost:5173 to access the frontend.
• Register or log in to create or participate in auctions.
• Browse available products, place bids, and monitor live updates.

Project Structure

• server/ - Backend code (Express)
  • models/ - MongoDB models
  • controllers/ - Route controllers
  • routes/ - API routes
  • config/ - Configuration files
• client/ - Frontend code (React)
  • components/ - Reusable UI components
  • pages/ - Application pages
  • redux/ - Redux slices and store
  • styles/ - Tailwind CSS for modern styling
  • hooks/ - Custom React hooks for state management

Contributing

Contributions are welcome! Please fork the repository and create a pull request with your changes. Make sure to follow coding standards and write clear, concise documentation when necessary.

License

This project is licensed under the MIT License - see the LICENSE file for details.