Clinical Ledger is a clinical knowledge workspace built for hospital teams. It helps departments capture notes, manage case libraries, run review workflows, and publish journals in one place.
- Workspace-based access with role permissions (
admin,editor,contributor,viewer) - Clinical notes with statuses, tags, comments, and version history
- Structured case management with imaging support
- Review requests and approval flow
- Department journals with printable output
- Workspace settings for members, branding, and audit views
- Next.js (App Router) + React + TypeScript
- Tailwind CSS + Radix UI components
- Supabase (Auth, Postgres, Storage)
- Zod + React Hook Form for validation/forms
- Install dependencies:
npm install- Create local environment file:
cp .env.local.example .env.localOn Windows PowerShell:
Copy-Item .env.local.example .env.local- Fill
.env.localwith your Supabase project values. - Start the app:
npm run dev- Open
http://localhost:3000.
Required values are documented in .env.local.example:
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEYSUPABASE_SERVICE_ROLE_KEYNEXT_PUBLIC_APP_URLNEXT_PUBLIC_APP_NAME
Optional upload limits are also included in the same file.
SQL migrations are in supabase/migrations.
Apply them in order using your preferred Supabase workflow (CLI or SQL editor), then verify tables/policies are created before running end-to-end flows.
npm run dev- start local dev servernpm run build- production buildnpm run start- run production server
src/app- routes, layouts, server actionssrc/components- UI and feature componentssrc/services- domain service layersrc/lib- utilities, validations, Supabase clientssupabase/migrations- schema and policy migrationspublic- static assets
This project is designed for clinical collaboration workflows. If you plan to use real patient data, make sure your deployment and operations meet your organization's legal, privacy, and security requirements.