About this software
About PetPlex – Pet Grooming Booking & Adoption Platform
PetPlex is a Next.js 15 frontend and Express 5 / Prisma / PostgreSQL API in one repository, covering a public website, a customer dashboard, a staff panel and a permission-based admin panel. Customers book services through a 4-step wizard that uses staff schedules, days off and existing bookings, and can apply to adopt listed pets. Admins manage bookings, services, staff, adoptions, content, reviews, messages and settings. Payments are not built in: the business takes payment offline. Email goes through Brevo and images through Cloudinary. The package includes Docker Compose, seed and demo data, API docs and a backend integration test suite. It has no mobile app and no frontend tests.
Why PetPlex – Pet Grooming Booking & Adoption Platform
What makes it better
than the alternatives
- 01
Availability-aware booking
The booking wizard offers live time slots based on staff weekly schedules, days off, blocked dates and existing bookings, with promo code support.
- 02
Booking and adoption in one platform
The same codebase handles grooming, spa, walking, sitting and daycare bookings plus adoption listings, applications and handover tracking.
- 03
Role-based permissions enforced by the API
Roles carry fine-grained permission slugs checked by server middleware on every request, with a super admin bypass and ownership checks tested in the suite.
- 04
Tested backend with security docs
Around 20 integration test files run against a real database, and docs/SECURITY.md describes auth, RBAC and rate limits; the frontend has no automated tests.
- 05
Ready to deploy and brand
Docker Compose, Dockerfiles, a Render config, env validation with zod, demo seed data, Swagger docs and a setup guide are included.
Public Website
- Home page with services
- opening hours and an Open now badge
- Service catalogue with categories
- BDT prices
- durations and pet-type compatibility
- Blog
- FAQ
- photo and video gallery with before/after
- and reviews
- Contact form and newsletter subscribe/unsubscribe
- SEO: metadata
- sitemap
- robots
- JSON-LD structured data
Booking
- 4-step wizard: service
- pet
- date and time
- confirm
- Promo codes: percentage or fixed
- per service or category
- with usage limits
- Customer cancellation within the allowed window
- Booking status history
Adoption
- Browsable adoption pets with filters for animal
- gender
- size
- age and fee
- Photo galleries and favourites
- Online adoption application form
- Admin review of applications and adoption handover
- contract and follow-up
Customer Dashboard
- Upcoming and past bookings with details
- Pet profiles with photo and vaccination status
- Reviews for completed visits
- adoption applications and favourites
- In-app notifications
- profile and password management
Staff Panel
- Today's and upcoming assigned bookings
- Status workflow: confirm
- in progress
- completed or no-show with reasons
- Notifications and profile
Admin Operations
- Dashboard KPIs
- booking value chart
- top services and needs-attention queues
- Bookings with filters
- staff assignment and status changes
- Customer 360° view and customer pets
- Services
- two-level categories
- pet types and promotions
- Staff skills
- weekly schedules
- days off and blocked holiday dates
Content and Inbox
- Markdown blog editor with scheduling
- FAQs
- testimonials and gallery albums
- Review moderation with replies
- Contact messages and newsletter subscribers with CSV export
Users, Roles and Security
- Registration with email verification and password reset
- Short-lived access token plus httpOnly refresh cookie with rotation
- Role and permission management
- Activity log
- rate limiting
- helmet
- CORS and hpp
Platform and Integrations
- Brevo email with a dry-run mode
- Cloudinary image uploads
- In-process jobs for token cleanup
- using Postgres advisory locks
- Swagger API docs
- Postman and API reference generators
| Language | Version | Framework | Used for | Share of code |
|---|---|---|---|---|
| TypeScript | — | — | Front-end | 45.5% |
| TypeScript (React) | — | — | Front-end | 41.5% |
| SQL | — | — | Database | 12.3% |
| Shell | — | — | Scripts | 0.4% |
| CSS | — | — | Styling | 0.3% |
| JavaScript | — | — | Front-end | 0% |
- Primary language
- TypeScript 5.9 (Node.js 22 LTS)
- Framework
- Next.js 15 (frontend) + Express 5 (API)
- Database
- PostgreSQL 16 with Prisma 7 ORM
- Authentication
- JWT access token kept in memory, refresh token in httpOnly cookie, role-based permissions, email verification and password reset
- Licence
- Single-site
- Screens
- 44
- Database tables
- 30
- Supported languages
- English UI only; currency BDT; timezone Asia/Dhaka; no RTL support
- Browser support
- Modern evergreen browsers (Next.js 15 defaults); no formal cross-browser test suite
| Minimum | Recommended | |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| RAM | 2 GB | 4 GB |
| OS | Linux (Alpine Docker images), Node.js 22.12+, PostgreSQL 16 | Linux (Alpine Docker images), Node.js 22.12+, PostgreSQL 16 |
| Est. monthly hosting | $15 | $15 |
```bash cp .env.example .env # set POSTGRES_PASSWORD, JWT_ACCESS_SECRET (32+ chars), SEED_SUPER_ADMIN_PASSWORD (12+ chars) docker compose up -d ```
```bash cd backend cp .env.example .env npm install docker compose up -d npx prisma migrate deploy npm run db:seed npm run build npm run start:prod ``` Run the frontend with `cp .env.example .env.local && npm install && npm run build && npm start` in `frontend/`, and set `NEXT_PUBLIC_API_URL` before building.
The repo includes `backend/render.yaml` (API service) and `frontend/vercel.json` (website). Set the environment variables from the `.env.example` files in your provider dashboard, then deploy each service from its folder.
Open the `petplex` folder, then follow `CLAUDE.md` and `HowToSetup.md`. Start the API with `cd backend && npm run dev` and the website with `cd frontend && npm run dev`.
Quality report
Manually reviewedHow to read the quality report
What this is. Every project on Vibe96 goes through an automated audit of its source code before a reviewer in Dubai checks it by hand. The score is out of 100; 75 is the minimum to be listed, and any single failing check blocks a listing regardless of the score.
- Security
- No real credentials in the code, every data-changing route protected, admin areas role-gated, no SQL built from user input.
- Code structure
- A developer can navigate and extend it: clear module boundaries, no giant files, little copy-paste.
- Docs & completeness
- The setup guide, example config, schema and required files the builder committed to are actually in the archive.
- Dependency health
- Packages pinned, no known critical vulnerabilities, no abandoned libraries in production paths.
- Build & deploy
- A clean machine can restore, build and start it by following the shipped instructions.
Warnings are problems that didn't block the listing; they stay visible here until a later version clears them. The audit reads the code — it does not run it — so always try the live demo before you buy. Lines of code are counted from the same audited archive.
Reviewer notes (5 minor)
No real credentials found; weak default db password fallbacks ship in docker-compose; authz design is sound, but only the auth module's routes could be verified; the rest is unreviewable; prisma-based access looks sound, but the digest excludes the service files and migrations needed to verify most checks; lockfiles present for both apps; caret ranges and a few version/pinning concerns, no confirmed critical cve; largely reproducible monorepo; a few unverifiable steps and minor inconsistencies in setup. None of these stop the software from working; the developer has been told and improvements come in a future update.
Versions & updates
No updates yet. New versions appear here with a changelog.
Buyers receive updates free for 1 year.
What you get
- </>Full source codeThe complete audited source, delivered as a download from your account. No obfuscation.
- ▤DocumentationSetup guide, architecture notes, CLAUDE.md and AGENTS.md.
- ↻One year of updatesEvery new version the builder publishes, free for 12 months.
- ♧30 days of supportInstallation and defect support through Vibe96 tickets.