A web application that allows users to publish lost items or items they have found. Other users can view these posts and provide assistance or information to help recover or return the items.
- Publish lost items with details and images.
- Publish found items with details and images.
- Search and browse through lost and found items.
- Secure user authentication and authorization.
- Manage user profiles and posts.
- MERN Stack: MongoDB, Express.js, React, Node.js
- Cloudinary: For image storage and management
- Multer: Middleware for handling file uploads
- JWT: JSON Web Tokens for secure authentication
- Bcrypt: For hashing passwords
- tailwind: for styling
- Clone the repository:
git clone https://github.com/prakashMpandey/lost-and-found.git
- Navigate to the project directory:
cd lostAndFound
- Install server-side dependencies:
npm install
- Install client-side dependencies:
cd ../frontend/lostFound npm install
- Create a
.env
file in thesrc
directory with the following environment variables:MONGO_URI=your_mongodb_connection_string ACCESS_TOKEN_SECRET=ANY SECRET STRING ACCESS_TOKEN_EXPIRY=ANY EXPIRY TIME REFRESH_TOKEN_SECRET=ANY SECRET STRING REFRESH_TOKEN_EXPIRY=ANY EXPIRY TIME CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name CLOUDINARY_API_KEY=your_cloudinary_api_key CLOUDINARY_API_SECRET=your_cloudinary_api_secret
- Replace placeholder values with your actual configuration details.
- Start the backend server server:
cd npm run dev
- Start the client:
cd frontend/lostFound npm start
- Open your browser and navigate to
http://localhost:5173
to use the application.
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Commit your changes (
git commit -am 'Add new feature'
). - Push to the branch (
git push origin feature-branch
). - Create a new Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- GitHub: @prakashMpandey