findmydoc portal

The findmydoc portal is a PayloadCMS‑powered platform that helps international patients discover trusted clinics and specialists.

License

This repository is proprietary and source-available. The source code may be visible, but the project is not open source and no permission is given to use, copy, modify, publish, distribute, redistribute, sublicense, or create derivative works from any part of this repository.

All rights are reserved by findmydoc. See LICENSE.md for the full license terms and CONTRIBUTING.md for contribution terms.

Quick Start

1. git clone https://github.com/findmydoc-platform/website.git
2. cp .env.example .env
3. pnpm install
4. start development: a. docker compose up or b. docker compose run --rm postgres & pnpm run dev
5. Open http://localhost:3000

Environment variables

• NEXT_PUBLIC_SUPABASE_RESET_REDIRECT — absolute URL that Supabase uses when sending password recovery emails. Point it to the public password reset completion page (for example, https://example.com/auth/password/reset/complete).

Development

• Connect to Vercel: see Setup Docs
• Migrations & Schema changes: see Setup Docs
• Seed database: see Setup Docs and detailed Seeding System
• Deployment process: see Deployment & Migration Runbook
• Local disposable DB reset: see Local Database Reset (Test Only)
• Local Development Setup: see Setup Docs
• UI atoms: all shadcn/ui primitives live in src/components/atoms and must be imported via @/components/atoms/<component>; run shadcn CLI commands only after confirming the alias still points to that folder in components.json.

Quality Gates

AI anti-slop and quality hygiene are enforced through local and CI lanes:

• Local lane: staged-file pre-commit checks plus a scoped pre-push AI-slop check for changed instruction files.
• Fast lane (PR blocking): merge-critical validation, tests, and build readiness.
• Security lane: workflow and secret scanning for CI/security-relevant changes plus scheduled runs.
• Semgrep lane: blocking SAST scans for application changes in pull requests and on main.
• Deep lane (main + nightly): anti-slop and repository hygiene checks such as dead-code and dependency health.

Key quality commands:

• pnpm ai:slop-check
• pnpm deadcode:check
• pnpm deps:graph:check
• pnpm deps:dedupe:check
• pnpm deps:audit

Hook setup:

• pnpm install configures .githooks automatically in local Git worktrees.
• pnpm hooks:install reapplies hook setup manually if needed.

Reference: AI Anti-Slop Playbook

Production

TBD

Documentation

• Documentation Index
• PayloadCMS Docs
• Features & Integrations
• PostHog Analytics
• Authentication System
• Setup & Development
• Storage Configuration
• Frontend Atomic Architecture
• Animation Stack
• Architecture Decision Records (ADRs)