# 🐾 paw❤️print

**Open-source rescue management platform — self-host free or use PawPrint Cloud.**

Modern, fast, mobile-first website and management system built for animal rescues. Everything a foster-based rescue needs, nothing it doesn't.

---

## What It Does

- 🐕 **Pet Management** — Profiles, photos, medical records, foster assignments, status tracking
- 📋 **Applications** — Adoption, foster, volunteer, surrender forms with configurable questions
- 🏠 **Foster Portal** — Dedicated dashboard for fosters to submit updates, photos, supply requests
- 💰 **Donations & Expenses** — Stripe payments, multi-source tracking, financial reports
- 📅 **Events** — Listings with optional Facebook auto-posting
- ✏️ **Content CMS** — Editable page sections, newsletter, happy tails / success stories
- 📊 **Analytics** — Human traffic, bot detection, honeypot, AI job tracking
- 🔐 **Role-Based Access** — 9 roles from sysadmin to foster with granular permissions
- 🤖 **Bot Protection** — Dynamic robots.txt, honeypot tarpit, managed blocklist/whitelist
- 🧠 **AI Features** — Pet name generator (Ollama), expandable job queue

## Tech Stack

- **SvelteKit 2** + **Svelte 5** (runes)
- **Tailwind CSS 4**
- **Drizzle ORM** + **MariaDB/MySQL**
- **Node.js** adapter for production
- **Stripe** for payments
- **Nodemailer** for email
- **Ollama** for local AI (optional)

## SaaS Architecture

PawPrint supports multi-tenant deployment:

- **Self-hosted** — One rescue, one server, free forever
- **PawPrint Cloud** — Automated onboarding, subdomain provisioning, managed hosting

See [docs/SAAS.md](docs/SAAS.md) for the multi-tenant architecture.
See [docs/ONBOARDING.md](docs/ONBOARDING.md) for automated provisioning.

## Quick Start (Self-Hosted)

```bash
git clone https://github.com/yourusername/pawprint
cd pawprint
cp .env.example .env
# Edit .env with your database URL, SMTP, etc.
npm install
npx drizzle-kit push
npm run seed
npm run dev
```

## PawPrint Cloud Pricing

| Plan | Price | What You Get |
|------|-------|-------------|
| **Self-Hosted** | Free | Full source, you manage everything |
| **PawPrint Cloud** | $19/mo | Managed hosting, subdomain, SSL, backups, updates |
| **Setup Assist** | $50 one-time | We migrate your data from your old site |

## License

MIT — use it, fork it, save some dogs.

---

Built with ❤️ by [JRei](https://reiners.dev) — started as Almost Home Canine Rescue's website, now open for every rescue.