A donation platform that helps raise funds for pets and animals requiring medical treatment or special care.
Huellas Vivas is a donation platform created to help pets and animals receive the medical care they need.
When a dog needs surgery, a cat requires treatment, or any animal faces high medical expenses, this platform allows people to create fundraising campaigns and receive support from others who care.
Because every paw leaves a mark. 🐶🐱
Huellas Vivas connects people who need help covering veterinary expenses with people who want to help.
Users can:
- Create donation campaigns
- Contribute to existing campaigns
- Share cases with others
- Comment and interact
- Track fundraising progress in real time
The goal is simple: make animal care more accessible through community support.
A post includes:
- Title
- Detailed description of the case
- Supporting evidence (photos, videos, medical documents)
- Target fundraising amount
- Real-time progress indicator
Once the goal is reached, the campaign is automatically marked as completed — but it can still receive additional donations.
Each post includes:
- A comment section
- The ability to reply to other users
- A visual category indicator (Dog, Cat, Rabbit, Others)
Posts are displayed in a vertical infinite scroll feed, similar to social media platforms.
- Passwords and sensitive data are securely encrypted.
- Donations are protected using blockchain-based escrow logic.
- Donors may request additional proof before releasing funds.
- Transparency is a priority.
To donate or create a campaign, users must register.
Registration includes:
- Username
- First name
- Last name
- Secure password
- Optional profile picture
After registering, users can:
- Donate
- Raise funds
- Receive notifications
- Manage their profile
Users receive notifications when:
- A donor requests additional proof
- A fundraiser submits requested proof
- A donation is successfully completed
| Layer | Technologies |
|---|---|
| Frontend | Next.js, React, TypeScript — minimalist and accessible UI (Tailwind CSS, shadcn/ui) |
| Backend | NestJS — RESTful API, scalable modular structure |
This is a monorepo: the frontend lives in the root and the API in a separate folder.
huellas-vivas/
├── app/ # Next.js App Router (pages, layouts)
├── components/ # Reusable UI (including shadcn/ui)
├── hooks/ # React hooks
├── lib/ # Utilities and shared logic
├── public/ # Static assets
├── backend/ # NestJS API
│ ├── src/ # Application source
│ └── test/ # Backend tests
├── CONTRIBUTING.md # Setup and contribution guide
└── README.md
- 🏠 Home — Infinite scroll feed
- 📝 Register
- 🔐 Login
- 👤 My Profile
Navigation is handled through a clean sidebar layout.
Huellas Vivas aims to:
- Promote transparency in fundraising
- Make donation campaigns accessible
- Build a scalable open-source solution
- Provide a clean and user-friendly experience
-
Node.js 18.18+ (20+ recommended)
-
pnpm (recommended via Corepack):
corepack enable corepack prepare pnpm@latest --activate -
Git
git clone https://github.com/YOUR_ORG/huellas-vivas.git
cd huellas-vivasFrontend (from repo root):
pnpm installBackend:
pnpm -C backend installUse two terminals: one for the frontend, one for the backend.
Terminal 1 — Frontend:
pnpm devThen open http://localhost:3000 in your browser.
Terminal 2 — Backend:
The API runs on a different port so it doesn’t conflict with Next.js (default 3000).
- Windows (PowerShell):
$env:PORT=4000 pnpm -C backend start:dev
- Windows (CMD):
set PORT=4000&& pnpm -C backend start:dev
- macOS / Linux:
PORT=4000 pnpm -C backend start:dev
The API will be available at http://localhost:4000.
- Lint frontend:
pnpm lint - Build frontend:
pnpm build - Lint backend:
pnpm -C backend lint - Test backend:
pnpm -C backend test
We welcome contributions. Please read CONTRIBUTING guide for:
- Detailed setup and run instructions
- Code style and project conventions
- Pull request process and commit guidelines
This project is currently unlicensed. See repository settings or contact the maintainers for usage terms.