👓 Eye Test Validator & Contact Lens Converter App

An interactive React application for validating and converting optical prescriptions (Eyeglasses & Contact Lenses).
Built with React + TypeScript + TailwindCSS, and powered by the backend logic from
📦 eye-test-utils npm package.

---

🌍 Live Demo

🚀 Try it here:
👉 https://elhussin.github.io/eye-test/

---

✨ Key Features

✅ Validate optical prescriptions (SPH / CYL / AXIS / ADD / PD)
✅ Automatic formatting into standard optical notation
✅ Lens transposition (positive → negative cylinder format)
✅ Contact lens power conversion with Vertex Distance adjustment
✅ Responsive UI — works great on mobile & print
✅ One-page printable output (A4 optimized)

---

🧠 Powered By

This app uses the optical validators package:

📦 NPM: eye-test-utils
🔗 https://www.npmjs.com/package/eye-test-utils
🔗 Repository: https://github.com/Elhussin/eye-test-utils

---

🖥️ Tech Stack

Layer	Technology
Frontend	React (TypeScript)
Styling	TailwindCSS
Notifications	Sonner
Build System	Vite
Deployment	GitHub Pages

---

📸 Screenshots

🖥️ Desktop View

📱 Mobile View

📄 Print View

---

🛠️ Development Setup

Clone the repo:

git clone https://github.com/Elhussin/eye-test
cd eye-test

Install dependencies:

npm install
# or
bun install

Run development server:

npm run dev
# or
bun run dev

Build for production:

npm run build
# or
bun run build

Deploy to GitHub Pages:

npm run deploy
# or
bun run deploy

Print-Ready View

When switching to View Mode, the UI becomes optimized for printing. ✅ Hidden buttons in print ✅ Fits into a single A4 page when possible

💬 Support & Contact

If you have any questions, need technical support, or want to discuss features, feel free to reach out:

• Email: hasin3112@gmail.com
• GitHub Issues: Open an Issue here (The preferred way to report bugs)

📜 License

This project is licensed under the MIT License.