Skip to content

MadhavDhatrak/HopesAlive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🐾 HopesAlive: Revolutionizing Animal Rescue

HopesAlive is a dedicated platform designed to bridge the gap between citizens, volunteers, and NGOs in addressing animal emergencies. Whether it's an injured animal or an accident involving one, HopesAlive provides a streamlined solution to report, assign, and resolve incidents with efficiency and compassion.


🐾 Whats is the problem

Every day, countless animals suffer from injuries or accidents, and often, they go unnoticed or unassisted. Traditional reporting methods are limited, and there is a lack of collaboration among the public, veterinary professionals, and shelters. We need a system that not only facilitates the reporting of these incidents but also provides a way for professionals to respond effectively.

🐾 What is HopesAlive?

HopesAlive is a web platform that empowers users to report animal-related incidents by uploading a photo and location details. The system ensures that the relevant NGOs and volunteers in the area are notified, enabling swift action. Volunteers and NGOs can manage incidents collaboratively, track statuses, and communicate seamlessly to save lives and bring aid to animals in need.


Data Sources (3)

🌟 The Problem We Solve

In many cities, there’s a lack of centralized platforms to report and handle animal-related emergencies. Key challenges include:

  • Difficulty in locating and notifying the right people who can help.
  • Lack of communication between volunteers and NGOs.
  • Inefficient tracking and resolving of incidents.

HopesAlive solves these problems by connecting citizens, volunteers, and NGOs on a single platform to:

  • Report incidents effortlessly.
  • Assign and manage tasks effectively.
  • Ensure timely and coordinated responses to animal emergencies.

🛠️ Tech Stack

Frontend:

  • React.js
  • Tailwind CSS
  • Daisy UI
  • Claude AI

Backend:

  • Node.js
  • Express.js
  • JWT Authentication
  • MongoDB

✨ Key Features

For Citizens:

  • Upload a photo of an injured animal with location details.
  • Track the status of a reported incident.

For Volunteers:

  • Dedicated dashboard to manage tasks.
  • Assign incidents to themselves for resolution.
  • Create new incidents if required.

For NGOs:

  • Centralized dashboard displaying all city-wide incidents.
  • Update incident statuses (Pending, In Process, Resolved).
  • Access statistics and analytics for better management.
  • Dedicated city map for visualizing incidents.

🚀 Getting Started Locally

1. Clone the Repository

git clone https://github.com/MadhavDhatrak/HopesAlive.git
cd HopesAlive

2. Configure Environment Variables

Create a .env file in the root directory and include the following:

PORT=3000
MONGO_URI=your-mongodb-link
JWT_KEY=your-secret-key

3. Backend Setup

cd backend
npm install
npm run start

Ensure all dependencies are installed. If errors occur, double-check your environment and installed packages.

4. Frontend Setup

cd frontend
npm install
npm run dev

5. Launch the Application

Visit the following URL in your browser: http://localhost:5173/

🤝 Contributing

We welcome contributions! If you’d like to improve HopesAlive, please fork the repository and submit a pull request.
For more information, check out the Contribution Guidelines

About

HopesAlive: Revolutionizing Animal Rescue

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages