PawHaven is a full-stack platform designed to support stray animal rescue and adoption, connecting volunteers, adopters, and the community.
The platform allows users to report rescue cases, track rescue progress, share rescue stories, and improve the visibility and coordination of rescue efforts.
In addition to the application itself, PawHaven also serves as a practice of modern full-stack engineering, focusing on scalable architecture, maintainable code, and efficient development workflows.
- Node.js:
25.x - pnpm:
11.x
Ensure you meet these version requirements before installing dependencies or running the project.
-
Rescue Case Management
Create and track rescue cases, helping volunteers coordinate rescue operations. -
Authentication & Authorization
Secure authentication with JWT and role-based access control. -
Knowledge Base
Provide rescue guides and adoption knowledge through a centralized content system. -
Community Interaction
Share rescue stories and exchange experiences within the community.
| Layer | Technology | Highlights |
|---|---|---|
| Frontend | React, TypeScript, React Query, React Hook Form | Scalable component-based architecture |
| Backend | NestJS, Node.js | Microservices for service isolation |
| Architecture | Monorepo + pnpm workspace |
Full-stack TypeScript with shared types across frontend/backend |
| Code Quality | ESLint, Prettier, Husky | Enforced standards, pre-commit hooks |
| CI/CD | GitHub Actions | Automated pipelines |
.codebuddy is the AI-driven development engine behind PawHaven β an agent orchestrator that turns every coding request into a structured pipeline: plan β dispatch agents β verify with tests β review against architecture & patterns β update knowledge.
π Enter the .codebuddy engine β workflows, agents, skills, principles & the task log
PawHaven is an open and evolving project.
If you are interested in animal rescue, open-source development, or project architecture discussions, you are welcome to join the community.
π¬ Discord
π https://discord.gg/znnG258E
You can use the Discord server to:
- discuss project ideas and features
- talk about technical architecture
- ask development questions
- collaborate with other contributors
Detailed documentation can be found in the .codebuddy/docs directory.
| Document | Description |
|---|---|
| Product Strategy | Complete product blueprint β 7 modules, personas, value flywheel, roadmap |
| System Architecture | 5-service architecture, modular monolith, DDD, event-driven, ADRs |
| Design System | Design tokens, Tailwind v4 theme, CSS utilities |
| Document | Description |
|---|---|
| Monorepo & Project Standards | Coding conventions, tooling, workflows |
| Authentication & Authorization Architecture | JWT-based auth flow and RBAC design |
| Route-Level Authentication | Frontend route guard implementation |
Contributions are welcome.
If you would like to contribute:
- Open an issue to discuss ideas
- Fork the repository
- Create a feature branch
- Submit a pull request