BridgeCare is an AI-powered telehealth platform that enables patients to complete medical intakes through an AI chatbot, which doctors can then review and take action on (prescribe, advise, or schedule follow-ups).

• Node.js (v18 or higher) - Download
• npm (comes with Node.js)
• OpenAI API Key (for the AI chat feature)

Mac/Linux:

git clone https://github.com/YOUR_REPO/Hack-the-Coast-2026.git
cd Hack-the-Coast-2026

Windows (Command Prompt or PowerShell):

git clone https://github.com/YOUR_REPO/Hack-the-Coast-2026.git
cd Hack-the-Coast-2026

Mac/Linux:

cd server && npm install && cd ../client && npm install && cd ..

Windows:

cd server && npm install && cd ..\client && npm install && cd ..

Create or edit the file server/.env:

Mac/Linux:

echo "OPENAI_API_KEY=your-openai-api-key-here" > server/.env

Windows (PowerShell):

Set-Content -Path server\.env -Value "OPENAI_API_KEY=your-openai-api-key-here"

Windows (Command Prompt):

echo OPENAI_API_KEY=your-openai-api-key-here > server\.env

Replace your-openai-api-key-here with your actual OpenAI API key.

Open a terminal and run:

Mac/Linux/Windows:

cd server
npm run dev

The server will start on http://localhost:3001.

Open a second terminal and run:

Mac/Linux/Windows:

cd client
npm run dev

The client will start on http://localhost:5173. Open this URL in your browser.

To register as a doctor, you will need a valid registration code. Available codes:

• BRIDGE2026
• DOCTOR001
• DOCTOR002
• DOCTOR003
• MEDSTAFF01

• Patient Portal: AI-powered medical intake chat, history, medication lookup, appointments, profile
• Doctor Portal: Dashboard with pending intakes, patient review, prescribe/advise/schedule actions, patient list
• AI Chat: Powered by OpenAI GPT-4o-mini with structured medical intake
• Medication Database: 100+ searchable medications with uses, side effects, and interactions
• Authentication: JWT-based auth with role-based access control

• Frontend: React 18, React Router v7, Tailwind CSS, Motion (animations), Lucide Icons
• Backend: Express.js, TypeScript, SQLite (better-sqlite3), OpenAI API
• Auth: JWT + bcryptjs

Hack-the-Coast-2026/
├── client/                  # React frontend (Vite)
│   └── src/
│       ├── pages/           # Patient & Doctor portal pages
│       ├── components/      # Shared components
│       ├── context/         # Auth context
│       └── lib/             # API wrapper
├── server/                  # Express backend
│   └── src/
│       ├── routes/          # API routes
│       ├── db/              # Database schema & seed
│       ├── middleware/       # Auth middleware
│       └── services/        # OpenAI integration
├── medication.json          # Medication database
└── README.md

• Chat not working: Make sure your OpenAI API key is set in server/.env
• Server won't start: Ensure Node.js v18+ is installed (node --version)
• Port already in use: Kill existing processes on ports 3001/5173 or change the port in the config
• CORS errors: Make sure the client is running on http://localhost:5173