eklavya-sus / dorm-deals-frontend

Check this site out by clicking on the given link :

DormDeals, a college marketplace.

DormDeals is a modern e-commerce website designed to cater to the needs of hostel residents. It provides a platform for users to buy and sell items.

Usage

To get started with DormDeals, follow these steps:

1. Registration/Login: Sign up or log in to your DormDeals account.
2. Browse Items: Explore a wide range of items listed by other users.
3. Search: Use the search functionality to find specific item.
4. Details: Click on any item for coplete details.
5. Sell: You can list any item by clicking on sell button and giving out details.
6. User Profile: Manage your user profile and view your listings.
7. Log out: Use the log out button to sign out of your account in the Profile section.

Features

• User Authentication: Secure registration and login functionality.
• Item Listings: Users can list items they want to sell with details.
• Item Search: Users can search for items based on categories or keywords.
• User Profiles: Personalized profiles for users to manage their listings.
• Responsive Design: Ensures a seamless experience across different devices.

Installation

To run the frontend locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/RishabhJain0721/Dorm-Deals-Frontend.git

2. Navigate to the project directory:

   cd Dorm-Deals-Frontend

3. Install dependencies:

   npm install

4. Start the development server:

   npm start

5. Open your web browser and visit http://localhost:3000 to access the application.

Note : This will only install the frontend part of the application.

Although the project will work with only the frontend part installed locally(because backend is hosted), you can install the backend part too and run the whole application locally. Visit this repo for the backend : https://github.com/RishabhJain0721/Dorm-Deals-Backend

Tech Stack

• Frontend: React.js, Tailwind CSS
• Backend: Node.js, Express.js
• Database: MongoDB
• Version Control: Git, GitHub

Screenshots

1. Welcome Page

2. Signup Page

3. Login Page

4. DashBoard Page

5. Item Page

6. Item-Selling Page

7. User Profile Page

8. About Page