🐾 ZooPed Web

A Modern, Comprehensive Kennel Management & Dog Pedigree Tracker

Features • Tech Stack • Getting Started • Deployment

---

📖 What is ZooPed?

ZooPed is the ultimate digital hub for dog breeders, kennel owners, and enthusiasts. Originally conceived as a mobile app, it is now fully ported to the web to offer a seamless, responsive, and beautiful glassmorphism-inspired experience.

Manage your dogs, track litters, log heat cycles, monitor finances, and predict Coefficient of Inbreeding (COI) using the built-in Matchmaker—all in one place.

---

✨ Key Features

🐕 Comprehensive Dog Profiles

• Full Identity Tracking: Store registration numbers, microchips, DNA profiles, and physical markings.
• Photo Galleries: Upload and manage galleries for each dog.
• Health & Show Records: Log vaccinations, exams, conformation shows, and trials.
• Heat Tracking: Record heat cycles and predict future cycles directly on the dashboard.

🧬 Pedigree & Matchmaker

• Interactive 3-Generation Pedigree: A visual family tree extending back to great-grandparents.
• Printable Certificates: Generate and print official Pedigree Certificates and Puppy Contracts.
• Matchmaker Tool: Predict the 5-generation Coefficient of Inbreeding (COI) by pairing a Sire and Dam.

🍼 Litters & Whelpings

• Mating Logs: Record pairings and let ZooPed predict the whelping date automatically (~63 days).
• Litter Management: Track puppies born alive, stillborn, and log associated costs.

📊 Kennel Analytics & Financials

• Dashboard Agenda: See upcoming whelpings and heat cycles at a glance.
• Analytics Hub: View kennel statistics, sex distribution, and breed breakdowns.
• Ledger: Track income and expenses categorized by type (Food, Vet, Stud Fee, Puppy Sale, etc.).
• Data Export: 1-click JSON backup of your entire SQLite database.

---

🛠️ Tech Stack

ZooPed Web is built with cutting-edge web technologies:

• Framework: Next.js 15 (App Router)
• Language: TypeScript
• Database ORM: Prisma
• Database: SQLite (Local Development)
• Styling: Vanilla CSS with modern Glassmorphism aesthetics
• SEO/Metadata: Built-in Next.js optimizations (Dynamic Sitemap, Robots.txt, OpenGraph)

---

🚀 Getting Started

Follow these steps to run ZooPed Web locally on your machine.

1. Clone the repository

git clone https://github.com/your-username/ZooPedWeb.git
cd ZooPedWeb

2. Install Dependencies

npm install

3. Setup the Database

ZooPed uses SQLite for local development out of the box. To initialize the database and push the schema:

npx prisma db push

(Optional: Run npx prisma studio to view and edit your database via a web interface)

4. Run the Development Server

npm run dev

Open http://localhost:3000 in your browser to see the app in action!

---

☁️ Deployment

ZooPed is optimized for deployment on Vercel. However, Vercel's serverless environment does not support persistent SQLite databases or local filesystem uploads.

Before deploying to Vercel, you must make the following adjustments:

1. Migrate the Database:
   • Change the provider in prisma/schema.prisma from "sqlite" to "postgresql" or "mysql".
   • Provide a persistent database URL (e.g., Supabase, PlanetScale, or Vercel Postgres) in your .env file.
   • Run npx prisma migrate dev to setup your cloud database.
2. Setup Cloud File Storage:
   • The current /api/dogs/[id]/photos route saves images to the local public/uploads folder.
   • You will need to integrate AWS S3, Cloudinary, or Vercel Blob to handle photo uploads in production.

---

Built with ❤️ for Breeders.