WeHelp is a web application that connects donors with individuals who need assistance. Donors can browse requests and offer help, while those in need can create requests for specific items or assistance.
Before you begin, ensure you have the following installed:
git clone https://github.com/yourusername/wehelp.git
cd wehelpNavigate to the backend directory and install dependencies:
cd backend
npm installCreate a .env file in the backend directory with the following content:
MONGODB_URI=mongodb://localhost:27017/wehelp
JWT_SECRET=your_jwt_secret_here
PORT=5000Start the backend server:
npm startThe backend server will run on http://localhost:5000
Open a new terminal, navigate to the frontend directory, and install dependencies:
cd frontend
npm installStart the frontend development server:
npm startThe frontend application will run on http://localhost:3000
- Open your browser and navigate to http://localhost:3000
- You can:
- Register as a donor to help others
- Register as a receiver to create requests for help
- Browse available requests
- Make donations to help others
wehelp/
├── backend/ # Backend server code
│ ├── models/ # Database models
│ ├── routes/ # API routes
│ ├── middleware/ # Custom middleware
│ └── server.js # Server entry point
├── frontend/ # Frontend React application
│ ├── public/ # Static files
│ └── src/ # React source code
│ ├── components/ # Reusable components
│ ├── pages/ # Page components
│ └── App.js # Main application component
└── README.md # Project documentation
- User authentication (Donors and Receivers)
- Create and manage donation requests
- Browse available requests
- Make donations
- Track donation status
- Anonymous donations option
- Secure pickup verification system
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
For support, please open an issue in the GitHub repository or contact the maintainers.