-
-
Referra landing page
-
simulated patient portal login
-
simulated patient portal dashboard
-
referrals view (software integration starts)
-
referrals modal to start scheduling via Referra
-
available specialists to schedule appointment with filtering system via Referra
-
AI scheduling modal that sends automated notifications (call/email) via Referra
Referra: Closing the Referral Gap
Our Inspiration
Referra was built to close one of healthcare's most dangerous gaps: the space between referral and appointment.
After a PCP visit, too many patients never make it to the specialist they urgently need. Not because doctors don't care. Not because patients are negligent. But because the process is fragmented, confusing, and full of friction.
PCPs want continuity of care.
Specialists want to treat patients who need them.
Patients want clarity and simplicity.
Yet referrals still go unfulfilled.
Referra was born to eliminate that breakdown — and turn referrals into completed care.
What it does
Referra is an intelligent referral coordination platform that transforms the broken handoff between primary care and specialists into a seamless, tracked journey.
For Patients:
- Receive referrals instantly via text/email with clear next steps
- Browse pre-vetted specialists based on insurance, location, and availability
- Book appointments directly through the platform
- Get automated reminders and follow-ups to ensure they complete care
For Primary Care Providers:
- Send digital referrals in seconds with context and urgency levels
- Track referral completion rates in real-time
- Receive notifications when patients book or miss appointments
- Close the loop on patient outcomes
For Specialists:
- Receive qualified referrals with full medical context
- Fill appointment slots with patients who actually need their expertise
- Reduce no-shows through automated patient engagement
- Send consultation summaries back to referring physicians
The platform acts as the connective tissue that healthcare has been missing — ensuring every referral becomes a completed appointment.
How we built it
Tech Stack:
- Frontend: React with a clean, accessible UI designed for healthcare providers and patients
- Backend: Node.js/Express API handling referral workflows and notifications
- Database: PostgreSQL for storing patient referrals, provider networks, and appointment data
- Communication: Twilio for SMS notifications and appointment reminders
- Authentication: Secure auth system with role-based access (PCP, specialist, patient)
- Deployment: Cloud-hosted for HIPAA-compliant scalability
Architecture: We built Referra around three core workflows:
- Referral Creation — PCPs input patient info, reason for referral, and urgency level
- Patient Matching — Our algorithm matches patients with in-network specialists based on location, availability, and specialty needs
- Completion Tracking — Automated follow-ups ensure patients book appointments, and PCPs receive status updates
The system was designed with healthcare interoperability in mind, ready to integrate with existing EHR systems through HL7/FHIR standards.
Challenges we ran into
1. Healthcare Data Complexity
Understanding insurance networks, specialist availability, and medical terminology required extensive research. We had to build a flexible data model that could handle varying provider structures.
2. HIPAA Compliance Considerations
Even in a hackathon setting, we took patient privacy seriously. Implementing secure data handling, encrypted communications, and access controls added significant complexity.
3. Multi-Stakeholder UX Design
Designing for three distinct users — PCPs, specialists, and patients — meant balancing clinical workflows with consumer-grade simplicity. We iterated constantly to keep each interface intuitive.
4. Real-Time Notification System
Building reliable SMS and email triggers for appointment reminders, referral updates, and follow-ups required careful orchestration of asynchronous events and error handling.
5. Time Constraints
Scoping a solution that addressed the full referral lifecycle while remaining buildable in a hackathon timeline forced us to prioritize ruthlessly and focus on core value.
Accomplishments that we're proud of
Built a functional end-to-end referral system — from PCP referral creation to patient appointment booking — in a single weekend
Created an intuitive three-sided platform — seamlessly serving patients, referring doctors, and specialists with role-specific interfaces
Implemented automated patient engagement — reducing the manual burden on healthcare staff while improving referral completion rates
Designed with real healthcare workflows in mind — our solution respects clinical processes rather than forcing providers into rigid tech patterns
Solved a measurable problem — studies show 50-70% of specialist referrals go unfulfilled; Referra directly addresses this crisis
Built something ready to scale — our architecture supports integration with EHR systems and can handle multi-provider networks
What we learned
Healthcare isn't broken because people don't care — it's broken because systems don't connect.
The referral gap isn't a people problem; it's a coordination problem. Technology can fix coordination.
Patients want agency, not just information.
Giving patients direct booking power (with smart defaults) is more effective than just sending them a list of phone numbers to call.
Doctors need closed-loop systems.
PCPs don't just want to make referrals — they want to know their patients followed through. Feedback loops build trust and improve outcomes.
Simplicity is essential in healthcare tech.
Providers are overwhelmed. Patients are stressed. If your solution adds friction, it will be abandoned. We learned to strip away everything non-essential.
Building for healthcare requires empathy and research.
We spent significant time understanding clinical workflows, insurance mechanics, and real patient pain points. Good healthcare tech starts with deep listening.
What's next for Referra
Short-term (Next 3-6 months):
- Pilot with a local primary care clinic and specialist network
- Integrate with a major EHR system (Epic, Cerner, or Athenahealth)
- Add patient outcome tracking (did they complete treatment? improve?)
- Build analytics dashboard showing referral completion rates and bottlenecks
Medium-term (6-12 months):
- Expand to multi-specialty networks (cardiology, orthopedics, mental health, etc.)
- Implement AI-powered specialist matching based on patient history and outcomes data
- Add telemedicine options for initial specialist consultations
- Build two-way communication channels between PCPs and specialists within the platform
Long-term Vision:
- Become the standard referral infrastructure layer for healthcare systems nationwide
- Use aggregated data to identify healthcare access gaps (specialist deserts, insurance coverage issues)
- Partner with insurance companies to improve network adequacy and patient outcomes
- Expand internationally to markets with fragmented healthcare coordination
Our moonshot goal:
Make unfulfilled referrals as rare as lost credit card transactions — turning healthcare coordination into a solved problem.
Referra isn't just a tool. It's the connective tissue healthcare has been missing.
Every specialist appointment that happens because of Referra is a patient who got the care they needed. That's worth building.
LINK: https://github.com/battmuck32138/reinforcement_learning.git
Built With
- body-parser
- claude
- cors
- css3
- dotenv
- elevenlabs
- es6+
- express.js
- fastapi
- gemini
- handlebars.js
- html5
- httpx
- javascript
- jwt
- mongodb
- mongoose
- node.js
- nodemon
- npi-registry-api
- pydantic
- tenacity
- twilio
- uvicorn
- vite

Log in or sign up for Devpost to join the conversation.