🌟 Overview
The PAL Optical Tool Kit was born out of a real-world need to reduce friction in the eyewear order workflow. The optical industry still relies heavily on paper forms, manual calculations, and disconnected processes. This toolkit brings those workflows into a modern, browser-based environment — accessible from any device, with data persisted in real time via Firebase.
The suite is designed to be modular: each tool handles a specific part of the process, and they all share a consistent UI and data layer so information flows naturally between them.
📁 Complete Toolkit
Detailed mapping of all 11 source HTML files from PALHTML directory with key features and demos
⭐ P.O.S.T. Write-Up System - Deep Dive
The flagship application - complete digital replacement for traditional paper write-ups (5000+ JS lines)
🔐 User Authentication
Secure login system with personalized access codes for 12 staff members (James→Lisa) with initials display.
📋 Patient Management
- ✅ New Patient Information Sheets (EN/ES/FR multi-language)
- ✅ HIPAA Consent Tracking
- ✅ Guardian Information for minors
- ✅ Insurance Details capture
- ✅ Patient History with one-click reload
🏥 Insurance Integration
| Type | |
|---|---|
| Private Pay | Cash |
| MEDICAID | Aetna, Humana, Wellcare etc. |
| EYE-MED | Commercial |
| VSP | Commercial (20% frame discount) |
Auto copay/allowance deductions, Medicaid billing codes (92340, prior auth).
📷 Camera Measurement Tool
┌────────────────────────────────────────────────────┐
│ CAMERA MEASUREMENT │
├────────────────────────────────────────────────────┤
│ 1. LEFT edge of credit card (85.6mm scale) │
│ ↓ │
│ 2. RIGHT edge of credit card │
│ ↓ │
│ 3. Center of RIGHT pupil │
│ ↓ │
│ 4. Center of LEFT pupil → Instant PD │
│ ↓ │
│ 5. Bottom of right lens → Instant Seg Height │
└────────────────────────────────────────────────────┘
5-click calibration using standard credit card for accurate PD/Seg measurements, auto-populates form.
🔍 Lens Catalog (400+)
| Popular Options | |
|---|---|
| Plastic | Varilux X ($530), Shamir III ($465) |
| Polycarbonate | Unity VIA ($410), Younger ($295) |
| High Index | 1.67/1.74 SV ($365/$400) |
| Transitions/Polarized | Light adaptive, KBCO, Drivewear |
Auto-pricing w/ insurance overrides, oversize/high Rx/add auto-charges (+$10-30).
🖨️ Print & Export
3-page professional output: Dual lab slips, Patient sheet (multi-lang), Waivers (expired Rx, POF, thickness, etc.). HTML auto-save w/ patient/job# timestamp.
Key Features
Full Write-Up Program
Complete prescription write-up tool with all standard optical fields, validation, and Firebase sync for instant saving and retrieval.
PAL Calculators
Automated calculations for seg heights, fitting cross placement, and progressive lens measurements to eliminate manual math errors.
Firebase Backend
Real-time Firestore database stores all orders and write-ups, with authentication so each user sees only their own data.
Order History
Searchable log of past orders with the ability to pull up, duplicate, or edit any previous write-up in seconds.
Mobile-First Design
Fully responsive layout designed to work on tablets and phones used at the dispensing table or lab bench.
Print-Ready Output
One-click print view formats the write-up into a clean, lab-ready document that matches industry standards.
🔧 Technical Stack
Browser Support: Chrome/Edge ✅, Firefox ✅, Safari ✅, Mobile ✅
Browser Support
| 🟦 Chrome/Edge | ✅ Recommended |
| 🟧 Firefox | ✅ Supported |
| 🟦 Safari | ✅ Supported |
📦 Quick Start
start index.html(Windows) → Click any tool 🖱️- For PWA/server:
npx serve .orpython -m http.server 8000
All tools work offline after first load ✨
🎯 Features
P.O.S.T. Digital Write-Up
Full replacement for paper slips
Real-Time Billing
Insurance adjustments & payments
Insurance (10+ Providers)
VSP/EyeMed/Medicaid
Responsive Design
Tablet/phone optimized
Dark Mode
Theme switching
Offline PWA
Service Worker caching
🔐 Security
- 🔑 Unique staff credentials
- 🔒 Firebase secure auth/DB
- 📋 HIPAA-compliant forms
- ⚠️ Note: Upgrade to BAA for production HIPAA
The Problem It Solves
Firebase Firestore Firebase Authentication Firebase Hosting Responsive DesignThe Problem It Solves
Traditional optical write-up processes involve handwritten forms, manual seg height calculations, and physical order logs that are easy to lose and hard to search. Errors in these calculations can result in incorrectly made lenses — a costly and time-consuming mistake for both the lab and the patient.
The PAL Optical Tool Kit eliminates these pain points by digitizing the entire workflow, providing instant validation, and keeping a permanent, searchable cloud record of every order.