• Overview
• Features
• Architecture
• Technology Stack
• Project Structure
• Components
• AI Integration
• Styling
• Setup & Installation
• Development
• Contributing
• License

HealthSync is a cutting-edge medical documentation system that leverages artificial intelligence to streamline the patient intake process. It provides real-time, structured medical charting with an intuitive interface for healthcare professionals.

• AI-Powered Documentation
  • Real-time speech-to-text for verbal input
  • Intelligent SOAP format adherence
  • Automated medical terminology validation

• Dual Chat Interface
  • Choose between two AI assistants (Ava & Eli)
  • Real-time conversation tracking
  • Voice input support with visual feedback

• Dynamic Charting Display
  • Warning and message categorization
  • Visual indicators for different entry types
  • Real-time updates during consultation

• Structured Data Output
  • JSON-formatted medical records
  • SOAP-compliant documentation
  • Automated follow-up question generation

HealthSync/
├── src/
│   ├── pages/
│   │   ├── index.js        # Main application router
│   │   ├── HomePage.js     # Initial selection interface
│   │   ├── ChatPage.js     # AI interaction interface
│   │   ├── Charting.js     # Medical documentation display
│   │   └── api/
│   │       └── agent.js    # Together AI integration
│   └── styles/
│       ├── index.css       # Global styles
│       ├── home.css        # Homepage styles
│       ├── chat.css        # Chat interface styles
│       └── charting.css    # Documentation styles

• Frontend

  • Next.js 13
  • React 18
  • TailwindCSS
  • Framer Motion

• AI Integration

  • Together AI API
  • OpenAI Whisper
  • Custom AI Agents (Ava & Eli)

• Development Tools

  • TypeScript
  • ESLint
  • Prettier
  • Husky

The project follows a modular architecture with clear separation of concerns:

• pages/ - Route components and API endpoints
• components/ - Reusable UI components
• styles/ - Global and component-specific styles
• lib/ - Utility functions and API clients
• types/ - TypeScript type definitions
• public/ - Static assets and resources

Key components include:

• ChatInterface - Main conversation UI
• VoiceInput - Speech recognition component
• ChartingDisplay - Medical documentation view
• AgentSelector - AI assistant selection interface

HealthSync uses Together AI's API for:

• Natural language processing
• Medical terminology validation
• Automated documentation generation
• Context-aware responses

• TailwindCSS for utility-first styling
• Custom CSS modules for complex components
• Responsive design for all screen sizes
• Dark/Light mode support

1. Install dependencies:

npm install

2. Create a .env. file:

TOGETHER_API_KEY=your_api_key_here

3. Start the development server:

npm run dev

• Build: npm run build
• Lint: npm run lint

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

Made with ❤️ for HackHive 2025