HealthScribe

HealthScribe is a Next.js-based health assistant workspace with:

• authentication (signup/login/OTP/NextAuth),
• user profile + info capture,
• symptom and report analysis routes,
• AI-powered parsing and assistant endpoints.

Branch analysis summary

Current branch is aligned with origin/main, which already contains merged work from origin/smit. Additional branches currently hold separate feature sets:

• origin/naish: OTP/signup-login focused updates
• origin/rd: UI + API additions
• origin/vercelAI: assistant/chat UI and API additions

For stability, this branch keeps the origin/main baseline and fixes compatibility issues so current APIs/build tooling run more reliably.

Workspace structure

Top-level key areas:

• src/app: Next.js App Router pages and API routes
• src/components: reusable UI and feature components
• src/lib: shared helpers (MongoDB connection, utilities, providers)
• src/models: Mongoose models (User, OTP, UserInfo)
• public: static assets

Important app/API directories:

• src/app/api/auth/[...nextauth]: NextAuth credentials flow
• src/app/api/register, login, check-user, send-otp, verify-otp: auth + onboarding
• src/app/api/submit-info, user-info: user metadata persistence
• src/app/api/parse-prescription, parse-test, process-medical-data, gemini, symptoms: AI/medical processing

Tech stack

• Next.js 14
• React 18
• Tailwind CSS
• MongoDB + Mongoose
• NextAuth
• AI SDK + Gemini/OpenAI route integrations

Prerequisites

• Node.js 18+ (recommended LTS)
• npm
• MongoDB instance

Environment variables

Create .env.local with the values your deployment requires:

• MONGODB_URI
• NEXTAUTH_SECRET
• JWT_SECRET
• OPENAI_API_KEY
• GOOGLE_API_KEY
• EMAIL_USER
• EMAIL_PASS

Getting started

npm ci
npm run dev

Open http://localhost:3000

Scripts

• npm run dev – run development server
• npm run build – production build
• npm run start – run production server
• npm run lint – lint with Next.js ESLint rules

Notes

• Build may require external network access for Google Fonts during next build.
• Mongo connection utilities are available through both:
  • @/lib/mongodb (primary)
  • @/utils/mongodb (compatibility alias)