Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arjuncvinod/lost-and-found

A website for people in our community to post lost and found items
https://github.com/arjuncvinod/lost-and-found

api-rest css expressjs mongodb nodejs reactjs

Last synced: about 2 months ago
JSON representation

A website for people in our community to post lost and found items

Awesome Lists containing this project

README

        

# Lost And Found

## Project Description:
The Lost and Found Bulletin Board project is a community-driven initiative that aims to make a positive impact in our local community. Its primary goal is to help individuals who have lost items, pets, or belongings by providing a simple and accessible platform to post information about their lost possessions. It also serves those who have found items and wish to return them to their rightful owners.

## Project Objectives
- **Create a User-Friendly Platform:** Develop and maintain a user-friendly website that allows community members to easily post information about lost or found items.
- **Foster Community Support:** Encourage community members to support each other in finding and reuniting with their lost items.
- **Reunite Owners with Lost Belongings:** Facilitate the reunification of lost items, pets, and belongings with their owners.
- **Promote Community Engagement:** Actively engage with the local community to promote the use of the Lost and Found Bulletin Board.
- **Provide Ongoing Support:** Continuously maintain and improve the platform to ensure it remains a valuable resource for the community.

### Languages Used:
#### Front end : ![React](https://img.shields.io/badge/react-%2320232a.svg?style=flat&logo=react&logoColor=%2361DAFB) ![CSS3](https://img.shields.io/badge/css3-%231572B6.svg?style=flat&logo=css3&logoColor=white)
#### Backend : ![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=flat&logo=node.js&logoColor=white) ![Express.js](https://img.shields.io/badge/express.js-%23404d59.svg?style=flat&logo=express&logoColor=%2361DAFB)
#### Database : ![MongoDB](https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=flat&logo=mongodb&logoColor=white)

### [live demo](https://lostandfound-acv.vercel.app)
### API - https://lostandfound-api.onrender.com

## Installation

### Step 1: Clone the Repository

```bash
git clone https://github.com/arjuncvinod/Lost-And-Found.git
cd lost-and-found
```
### Install server dependencies
```console cd server
cd backend
npm install
```
### Install client dependencies
```console
cd frontend
npm install
```
### Start the server
```console
cd backend
npm start
```
### Start the client
```console
cd frontend
npm start
```
```python
The server will run on http://localhost:8000, and the client will be available at http://localhost:3000
```

### screenshots
1![image](https://github.com/arjuncvinod/Lost-And-Found/assets/68469520/7b68e817-1a62-4dfb-835f-6008379f752d)
3![image](https://github.com/arjuncvinod/Lost-And-Found/assets/68469520/1b137131-d0bc-4fc8-a737-6c2c797e45dc)
3![image](https://github.com/arjuncvinod/Lost-And-Found/assets/68469520/a19cdaa6-7003-4116-8429-d663c5a4dc10)
4![image](https://github.com/arjuncvinod/Lost-And-Found/assets/68469520/6f7b09e9-a997-4b20-984d-014c14468557)
5![image](https://github.com/arjuncvinod/Lost-And-Found/assets/68469520/337b8c7c-c689-480f-b45a-8de7fc77e7c7)