Skip to content

"Lost & Found: My ongoing MERN project aims to solve the campus's lost items issue. Using React for the front-end, Express for the back-end, and MongoDB for the database, I'm creating a real-time chat system with Socket.io to help people find their lost belongings."

Notifications You must be signed in to change notification settings

i-m-Paras/LostNFound

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 

Repository files navigation

LostNFound

LostNFound is an ongoing MERN (MongoDB, Express, React, Node.js) project designed to address the common issue of lost items on campus. The project focuses on creating a platform where users can report and search for lost belongings. The application utilizes React for the front-end, Express for the back-end, and MongoDB as the database. Additionally, a real-time chat system powered by Socket.io is integrated to facilitate communication between users and aid in the process of recovering lost items.

Getting Started

Explore the LostNFound application using the provided sample credentials:

Access the app: LostNFound App

Features

  • User Authentication: Users can create accounts, log in, and report lost items, enhancing the overall functionality of the platform.
  • Real-time Chat System: Integrated Socket.io to enable real-time communication between users, fostering a quick and efficient process for recovering lost items.
  • Lost Item Reporting: Users can report lost items by providing details such as item description, location, and contact information.
  • Search Functionality: Allows users to search for lost items based on various criteria, making it easier to locate belongings.
  • Responsive Design: Utilizes React for a responsive and intuitive user interface across different devices.

Technologies Used

  • Front-end: React
  • Back-end: Express.js
  • Database: MongoDB
  • Real-time Communication: Socket.io

Installation and Setup

Follow these steps to set up the project locally:

  1. Clone the repository:

    git clone https://github.com/i-m-Paras/lostnfound.git
  2. Install dependencies:

    cd lostnfound
    npm install
  3. Configure environment variables:

    Create a .env file in the root directory and set the following variables:

    PORT=3000
    MONGODB_URI=your_mongodb_uri
    SESSION_SECRET=your_session_secret
  4. Run the application:

    npm start
  5. Open your browser and navigate to http://localhost:3000 to access the application.

Future Enhancements

  • Implement user profiles for a more personalized experience.
  • Enhance the search functionality with advanced filters.
  • Upgrade image upload capabilities for lost items.

Contact

For any questions, feedback, or collaboration opportunities, feel free to contact us at awasthiparas6@gmail.com.

About

"Lost & Found: My ongoing MERN project aims to solve the campus's lost items issue. Using React for the front-end, Express for the back-end, and MongoDB for the database, I'm creating a real-time chat system with Socket.io to help people find their lost belongings."

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published