Skip to content

🐱 PawHaven β€” an open-source platform that helps volunteers, shelters, and adopters report, track, and share stray animal rescue cases (from first sighting to outcome).

License

Notifications You must be signed in to change notification settings

aoda-zhang/PawHaven-FullStack-React-NestJS

Repository files navigation

English | δΈ­ζ–‡

🐾 PawHaven

TypeScript React Node.js NestJS pnpm License: MIT

An open-source animal rescue platform that empowers volunteers, shelters, and adopters with digital tools to report, track, and share animal rescue cases.

image.png

🌍 Live: PawHaven


✨ Highlights

  • Built around real-world animal rescue needs, informed by research and industry interviews

  • Uses a Monorepo architecture to unify frontend, backend, and shared code, supporting consistent standards, collaboration, and long-term evolution

  • Designed for multi-role collaboration, enabling volunteers, rescue organizations, and adopters to work together

  • Frontend modules follow core feature modularization, making reporting, tracking, and story-sharing independently maintainable and extendable

  • Backend follows a microservices-oriented modular design for maintainability and scalability


🧠 Core Domains & Features

  • Identity & Trust – user authentication, role-based access, and volunteer credibility
  • Rescue Case Management – report rescues, track progress, assign status, and handle guides
  • Knowledge & Rescue Guides – practical guidance for volunteers and shelters
  • Community & Stories – share rescue outcomes, raise awareness, and engage adopters

🧰 Tech Stack & Tooling

  • Frontend: React + Redux Toolkit (global state) + React Query (server state) + React Hook Form
  • Backend: NestJS + Prisma + MongoDB
  • Shared Packages: reusable UI components, types, and utilities
  • Infrastructure: Monorepo with pnpm, GitHub Actions CI/CD

πŸ“š Table of Contents

  • πŸ’» Application Overview
  • βš™οΈ Monorepo & Project Standards
  • πŸ—„οΈ Repository Structure
  • 🧱 Shared Packages & UI Library
  • πŸ“‘ API & Backend Architecture
  • πŸ—ƒοΈ Frontend Architecture & State Management
  • ⚠️ Error Handling & Monitoring

πŸš€ Getting Started

To run PawHaven locally, please refer to the Development Guide for detailed instructions:

πŸ‘‰ Development Guide

About

🐱 PawHaven β€” an open-source platform that helps volunteers, shelters, and adopters report, track, and share stray animal rescue cases (from first sighting to outcome).

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •