About this software
About ClinicFlow — Multi-Tenant Clinic Management & Appointment System
ClinicFlow is a Next.js 16 / React 19 / TypeScript web app on Prisma 7 and PostgreSQL (Neon-oriented, with a Docker Compose stack for local evaluation). Patients book through a public 5-step wizard without an account and manage appointments via HMAC-signed links. Clinic staff work from a live calendar, patient records, waitlist, SMS templates and reports, while platform admins manage clinic tenants, background jobs and audit logs. The UI ships in English, Bengali and Arabic (with RTL), and SMS goes out through Twilio, SSL Wireless or a generic HTTP gateway configured per clinic. The repo includes unit, integration and Playwright e2e tests plus setup, security, deployment and API docs. It is a responsive web app only; no native mobile apps or payment processing are evidenced.
Why ClinicFlow — Multi-Tenant Clinic Management & Appointment System
What makes it better
than the alternatives
- 01
Database-level double-booking guard
Postgres btree_gist exclusion constraints in migrations back the scheduling engine, rather than relying only on application checks.
- 02
Accountless patient self-service
Patients reschedule or cancel via HMAC-signed token links (/a/[token]) subject to per-clinic cutoff and reschedule limits.
- 03
Per-clinic SMS provider choice
Twilio, SSL Wireless (ISMS Plus) and a generic HTTP adapter, with credentials stored encrypted using AES-256-GCM and switchable in the dashboard.
- 04
Trilingual with RTL
English, Bengali and Arabic message catalogs with right-to-left support across the public and dashboard routes.
- 05
Security-minded auth and tests
Argon2 password hashing, rate-limited login, atomic account lockout (tested for concurrency), audit logging and a tenant-isolation test suite.
Public Booking
- 5-step wizard: service
- doctor or any available
- date/time slot
- details
- confirmation
- Public clinic landing page and doctor profile pages
- No account required for patients
- Slot picker driven by availability
- buffers
- minimum notice and max advance days
Appointment Self-Service
- Token-secured manage
- reschedule and cancel pages
- Cancel and reschedule cutoff hours and max reschedules set per clinic
Live Calendar & Appointments
- Day/week calendar by doctor or room with live refresh
- Status transitions such as confirmed
- checked-in
- in-progress
- completed
- Staff booking form and appointment detail/list pages
Waitlist
- Public waitlist signup per clinic
- Automatic offers to waitlisted patients when slots open
- Configurable offer window
- offer count and optional auto-book
Patient Records
- Patient list
- create and detail pages
- Phone-based duplicate detection and trigram search (pg_trgm)
- Notes
- locale and SMS preferences
SMS & Notifications
- Twilio
- SSL Wireless and generic HTTP adapters
- Editable message templates
- 24h and 2h reminder jobs via a PostgreSQL job queue
- In-app notifications page
Clinic Administration
- Doctors
- rooms
- services
- schedules and exceptions management
- Staff management and roles pages
- Clinic settings
- content and media (images stored in PostgreSQL)
- Audit log viewer
Reports
- Reports page with outcomes chart
- CSV exports via S3-compatible storage
Platform Admin
- Clinic tenant provisioning and activation
- Provider catalog
- system and job monitoring
- platform settings
Deployment & Quality
- Dockerfile and Docker Compose with migrate and seed
- Prisma migrations and seed script
- Vitest unit/integration and Playwright e2e tests
- Docs: setup
- environment
- security
- testing
- deployment
- API reference
| Language | Version | Framework | Used for | Share of code |
|---|---|---|---|---|
| TypeScript (React) | — | — | Front-end | 59.4% |
| TypeScript | — | — | Front-end | 30.5% |
| SQL | — | — | Database | 9% |
| CSS | — | — | Styling | 1.1% |
- Primary language
- TypeScript 5.9 on Node.js 22+
- Framework
- Next.js 16 (App Router) with React 19
- Database
- PostgreSQL 17 (Neon) with Prisma 7; btree_gist and pg_trgm extensions
- Authentication
- Email and password sessions with Argon2 hashing, account lockout, rate limiting, and HMAC-signed patient links (no patient account needed)
- Licence
- Single-site
- Screens
- 48
- Database tables
- 20
- Supported languages
- English, Bengali, Arabic; full RTL layout for Arabic
- Browser support
- Modern evergreen desktop and mobile browsers (no explicit browser matrix in the digest)
| Minimum | Recommended | |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| RAM | 1 GB for the app (plus a PostgreSQL 17 database) | 4 GB for the app (plus a managed PostgreSQL 17 database) |
| OS | Linux with Node.js 22+ (Docker image uses node:22-alpine) and PostgreSQL 17 | Linux with Node.js 22+ (Docker image uses node:22-alpine) and PostgreSQL 17 |
| Est. monthly hosting | $30 | $30 |
```bash cp "Next.js Web App/.env.example" .env # Fill POSTGRES_PASSWORD, AUTH_SECRET, CREDENTIAL_ENCRYPTION_KEY and SCHEDULER_SECRET in .env docker compose up --build ``` The migrate service applies Prisma migrations and seeds demo data, then the app starts on port 3000.
```bash cd "Next.js Web App" cp .env.example .env.local # Set DATABASE_URL, DIRECT_URL, AUTH_SECRET, CREDENTIAL_ENCRYPTION_KEY, SCHEDULER_SECRET, APP_URL npm ci npm run db:migrate npm run build npm run start ```
```bash cd "Next.js Web App" npm ci npm run db:migrate npm run build ``` Set the same environment variables in the host dashboard, use the Neon pooled URL for DATABASE_URL and the unpooled URL for DIRECT_URL, then run `npm run start` or deploy the build output.
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 (3 minor)
No real credentials found; shared demo password and dev-default secrets ship to buyers; structure is organized by feature, but the project ships duplicated trees, a large vendored skills folder, and generated/tokenade artifacts; database layer not verifiable from digest; schema and duplication concerns, no confirmed injection; duplicated app tree, committed generated code and unverified setup doc leave build reproducibility unclear; caret ranges everywhere and no lockfile visible; dependency set can't be verified as free of known cves; authz not verifiable: server actions and route handlers were not shown; design claims guards but evidence is missing. 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.