Recov is a university project designed to help students track lost and found items. Built with the MERN stack (MongoDB, Express, React, Node.js), this web application allows users to report lost items, found items, view logs, and manage their accounts. An admin dashboard provides additional features for managing and categorizing reports.
- Lost Item Report Form: Allows users to report items they have lost.
- Found Item Report Form: Allows users to report items they have found.
- Logs: View logs of all found or reported items.
- My Account: Manage user accounts, including password changes and submission management.
- Admin Dashboard: Admins can view stats, categorized item reports, and claim/report request logs.
Recov/
├── /node_modules
├── /public
│ └── all icons and loaders etc.
├── /src
│ ├── /components
│ ├── /contexts
│ ├── /pages
│ ├── App.tsx
│ └── Protect.tsx
│ └── index.css
│ └── main.tsx
├── /server
│ ├── /controllers
│ ├── /models
│ ├── /routes
│ ├── /utils
│ ├── config.env
│ └── server.ts
├── .gitignore
├── package.json
├── tsconfig.json
└── webpack.config.js
Frontend
- Install dependencies:
npm install
- Run the frontend server:
npm run dev
- Navigate to the server directory:
cd server
- Install dependencies:
npm install
- Run the backend server:
node server.js
- Frontend: Configured using Vite.
- Backend: Environment variables are managed in
server/config.env
.
- Ensure both frontend and backend servers are running to access the full functionality of the application.
- The project uses Vite for fast builds and development.
Feel free to contribute to this project. For any issues or suggestions, please open an issue or create a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.