Skip to content

Searching - Lost and Found Platform: A web platform designed to connect people who have lost items with those who have found them. The platform facilitates easy reporting, searching, and recovering of lost items through a user-friendly interface.

License

Notifications You must be signed in to change notification settings

MRiDuL-ICE/Searching-Client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

535a60b Β· Mar 6, 2025

History

2 Commits
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Mar 6, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025
Jan 15, 2025

Repository files navigation

πŸ” Searching - Lost and Found Platform

Overview

A web platform designed to connect people who have lost items with those who have found them. The platform facilitates easy reporting, searching, and recovering of lost items through a user-friendly interface.

🌐 Live Demo

Visit Live Site

✨ Features

  • User Authentication

    • Email/Password login
    • Google Sign-in
    • Protected routes for authenticated users
  • Item Management

    • Report lost/found items
    • Upload item images
    • Add detailed item descriptions
    • Specify location and date
  • Search & Filter

    • Search by title/location
    • Toggle between table/card view
    • Responsive design for all devices
  • Item Recovery

    • Mark items as recovered
    • Track recovery details
    • Contact item finder/owner

πŸ›  Technologies Used

  • React 18
  • Tailwind CSS
  • Firebase Authentication
  • Node.js & Express
  • MongoDB

πŸ“¦ NPM Packages

  • react-router-dom - Routing
  • axios - HTTP requests
  • react-datepicker - Date selection
  • react-icons - UI icons
  • react-helmet - Dynamic page titles
  • framer-motion - Animations
  • sweetalert2 - Notifications
  • react-modal - Modal dialogs
  • tailwindcss - Styling
  • daisyui - UI components

πŸš€ Installation

# Clone repository
git clone [(Comming soon...)]

# Install dependencies
npm install

# Start development server
npm run dev

πŸ”§ Set up Firebase Configuration

  1. Go to the Firebase Console.
  2. Create a new project or select an existing project.
  3. Add a new web app to your project.
  4. Copy the Firebase configuration object.

Create a .env file in the root directory:

VITE_apiKey=your-api-key
VITE_authDomain=your-auth-domain
VITE_projectId=your-project-id
VITE_storageBucket=your-storage-bucket
VITE_messagingSenderId=your-messaging-sender-id
VITE_appId=your-app-id

πŸ“ Project Structure

β”œβ”€β”€ public
β”‚   β”œβ”€β”€ [index.html](http://_vscodecontentref_/1)
β”‚   └── ...
β”œβ”€β”€ src
β”‚   β”œβ”€β”€ assets
β”‚   β”‚   └── img
β”‚   β”‚       └── aboutImage.jpg
β”‚   β”œβ”€β”€ components
β”‚   β”‚   β”œβ”€β”€ Header.jsx
β”‚   β”‚   β”œβ”€β”€ Footer.jsx
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ context
β”‚   β”‚   └── AuthContext.jsx
β”‚   β”œβ”€β”€ hooks
β”‚   β”‚   β”œβ”€β”€ useAuth.jsx
β”‚   β”‚   └── useAxiosSecure.jsx
β”‚   β”œβ”€β”€ pages
β”‚   β”‚   β”œβ”€β”€ About
β”‚   β”‚   β”‚   └── About.jsx
β”‚   β”‚   β”œβ”€β”€ Home
β”‚   β”‚   β”‚   └── Home.jsx
β”‚   β”‚   β”œβ”€β”€ LostAndFound
β”‚   β”‚   β”‚   └── LostandFoundItems.jsx
β”‚   β”‚   β”œβ”€β”€ MyItems
β”‚   β”‚   β”‚   └── MyItems.jsx
β”‚   β”‚   β”œβ”€β”€ RecoveredItems
β”‚   β”‚   β”‚   └── RecoveredItems.jsx
β”‚   β”‚   β”œβ”€β”€ Register
β”‚   β”‚   β”‚   └── Register.jsx
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ App.jsx
β”‚   β”œβ”€β”€ main.jsx
β”‚   └── ...
β”œβ”€β”€ .env
β”œβ”€β”€ .gitignore
β”œβ”€β”€ [README.md](http://_vscodecontentref_/2)
β”œβ”€β”€ [package.json](http://_vscodecontentref_/3)
└── ...

πŸ”’ Authentication

  • Email/Password login
  • Google Sign-in
  • Protected routes for authenticated users

🎨 Design Philosophy

  • Clean and intuitive user interface
  • Responsive design for all devices
  • Easy navigation and accessibility

πŸ“ž Contact

For any inquiries or issues, please contact us at [abdulwahab22400@gmail.com].

πŸ™ Acknowledgements

  • Firebase for authentication and database services.
  • React for the front-end framework.
  • Tailwind CSS for styling.
  • SweetAlert2 for beautiful alerts.
  • React Icons for icons.
  • Framer Motion for animations.

🀝 Contributing

  • Fork the repository
  • Create your feature branch
  • Commit your changes
  • Push to the branch
  • Create a pull request

About

Searching - Lost and Found Platform: A web platform designed to connect people who have lost items with those who have found them. The platform facilitates easy reporting, searching, and recovering of lost items through a user-friendly interface.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages