A web-based eye health screening app that guides users through 8 vision tests with voice guidance and AI-powered result analysis.
- 8 Vision Tests — Visual Acuity, Color Vision, Astigmatism, Contrast Sensitivity, Near Vision, Peripheral Vision, Amsler Grid, and Symptoms Check
- Voice Guidance — Audio instructions throughout each test
- AI Analysis — Gemini API interprets results and provides a health summary
- PDF Report — Download your results as a PDF
- Results Dashboard — Visual summary of all test outcomes
- Node.js (v16 or higher)
- A Google Gemini API key
-
Clone or download the repository and navigate to the project folder:
cd eye-app/visioncheck -
Install dependencies:
npm install
-
Add your Gemini API key to
.env.localin thevisioncheck/directory:REACT_APP_GEMINI_KEY=your_api_key_here
A
.env.exampletemplate is included for reference. The.env.localfile is gitignored and will never be committed. -
Start the development server:
npm start
The app will open at http://localhost:3000.
| Command | Description |
|---|---|
npm start |
Runs the app in development mode |
npm run build |
Builds the app for production |
npm test |
Runs the test suite |
- React 19 — UI framework
- Google Generative AI SDK — Gemini API integration
- html2canvas + jsPDF — PDF report generation
- Create React App — Build tooling