maxwell-tebi/biobrief

BioBrief — AI-powered medical lab result translator for Ghana. Explains results in plain English and Twi, with symptom checking and clinic finder. # BioBrief BioBrief helps patients in Ghana understand their medical lab results. Upload a lab result image or paste the text, and the app explains what the values mean in plain English and Twi (Akan), suggests relevant foods to eat or avoid, checks how your symptoms connect to your results, and shows health facilities near you. --- ## Features - **Lab Result Analysis** -- Upload a photo of your lab result or paste the text directly - **Plain Language Explanations** -- Flags abnormal values and explains what they mean without medical jargon - **Twi Translation** -- Every section can be switched to Twi (Akan) with one click - **Dietary Suggestions** -- Lists foods to eat more of and foods to reduce, based on your flagged values - **Symptom Checker** -- Describe how you feel and get an explanation of how your symptoms may relate to your results - **Clinic Finder** -- Uses your browser location to show nearby hospitals, clinics, and health centres on a map --- ## Tech Stack | Layer | Technology | |---|---| | Frontend | React 18, Vite, Axios | | Backend | Node.js, Express.js, Multer | | AI | Google Gemini 2.5 Flash | | Maps | OpenStreetMap (embed), Overpass API | | Deployment | Vercel (frontend), Render or Railway (backend) | No database. The app is fully stateless. --- ## Project Structure ``` biobrief/ ├── client/ # React frontend │ ├── public/ │ ├── src/ │ │ ├── components/ │ │ │ ├── LanguageToggle.jsx │ │ │ ├── LoadingSpinner.jsx │ │ │ ├── ResultPanel.jsx │ │ │ ├── SymptomChecker.jsx │ │ │ └── UploadPanel.jsx │ │ ├── pages/ │ │ │ └── ClinicFinder.jsx │ │ ├── services/ │ │ │ └── analyzeService.js │ │ ├── App.jsx │ │ ├── App.css │ │ └── main.jsx │ ├── index.html │ └── vite.config.js ├── server/ # Express backend │ ├── middleware/ │ │ └── upload.js │ ├── routes/ │ │ ├── analyze.js │ │ └── symptoms.js │ ├── services/ │ │ …