Skip to content

Repository files navigation

VoiceUp Logo

VoiceUp 🎙️🚨

The Urgent Language Bridge

An offline-capable, privacy-first Progressive Web App bridging language barriers in medical emergencies when every second counts.
Built for HackAmerica 2026

React Vite Tailwind CSS Framer Motion Gemini API


🛑 The Problem

Language barriers during medical emergencies and school clinic visits cost lives, create extreme anxiety, and lead to critical misdiagnoses. Existing tools require internet access (which fails in basements or rural areas), have complex UIs, and store sensitive medical data in the cloud.

💡 Our Solution: VoiceUp

VoiceUp is a blazing-fast, offline-capable bridging system built for crisis situations. It utilizes native Web Speech APIs paired with the intelligence of Google Gemini to provide seamless bilingual communication.

By running entirely as a Progressive Web App (PWA) with edge-based local storage, VoiceUp requires zero backend servers, ensuring 100% HIPAA-compliant data privacy—your medical IDs never leave your device.


✨ Premium Features

  • 🌍 Real-Time Voice Translation: Instant speech-to-text and text-to-speech utilizing the browser's native Web Speech API.
  • 🧠 Gemini AI Integration: Generates context-aware, predictive translation suggestions (e.g., "Where does it hurt?") to speed up triage.
  • 📴 Offline Emergency Phrase Board: A categorized grid of highly-visible emergency phrases (Medical, Safety, School Clinic) available without an internet connection.
  • 🏥 Bilingual Medical ID Card: Securely store critical health information locally, translatable instantly, or generate a printable ID card.
  • 🎨 $10k Premium UI Experience: Built with state-of-the-art Glassmorphism, 3D physics-based animations (Framer Motion), and responsive animated mesh gradients.

🛠️ Technical Architecture

VoiceUp was engineered to be highly resilient and cost-effective (Zero Cost Infrastructure):

  • Frontend Ecosystem: React 18 + Vite for rapid compilation and optimized chunking.
  • Styling Engine: Tailwind CSS + custom Glassmorphism utilities + Lucide React Iconography.
  • Animation Physics: Framer Motion (AnimatePresence, staggered springs) to simulate tactile, hardware-accelerated button depresses.
  • Data Persistence: Browser localStorage acts as a zero-latency pseudo-database.
  • APIs: Native Web Speech API (transcription) + Google Gemini Pro (intelligent conversational suggestions).

🚀 Quick Setup & Deployment

You can test VoiceUp locally in seconds. No complex databases required!

Prerequisites

  • Node.js (v18+)
  • A Google Gemini API Key (Optional: The app includes a fallback or you can input your own in the Settings tab!)

Installation

# 1. Clone the repository
git clone https://github.com/SaifullahSayyed/VoiceUp.git
cd VoiceUp

# 2. Install dependencies
npm install

# 3. Spin up the development server
npm run dev

Browse to http://localhost:5173 to experience the 3D interface interactively!


🏆 HackAmerica 2026 Submission

This project was conceptualized, designed, and engineered entirely for the HackAmerica 2026 National High School Hackathon.

Focus Areas Conquered:

  • Impact: Solving a localized, high-stress social issue (school clinic language barriers).
  • Technical Achievement: PWA implementation, Local Storage manipulation, and AI API integration without backend costs.
  • Design: Setting a new standard for Hackathon UI/UX with modern glass components.

"Because in an emergency, language should never be a barrier."

About

VoiceUp is an offline-capable, bilingual PWA bridging language barriers in medical emergencies. Built with React, Framer Motion, native Web Speech APIs, and Google Gemini AI, it provides real-time translation, intelligent suggestions, and local medical ID storage when every second counts. Built for HackAmerica 2026

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages