Eye Trainer

A minimalist, browser-based eye exercise tool. A ball moves across the screen in various patterns for you to track with your eyes.

Features

• Movement modes - Horizontal, Bounce, Circular, Calm Random
• Adjustable settings - Speed, ball size, and colour
• Pause/Resume control
• Collapsible control panel - hide the bottom bar for a distraction-free experience
• Mobile-friendly - responsive layout that works on phones and tablets
• No dependencies - pure HTML, CSS, and JavaScript

Quick Start

cp .env.example .env   # optional, defaults are fine
docker compose up -d

Open http://localhost:50002 in your browser.

Configuration

Copy .env.example to .env and edit the values:

Variable	Default	Description
CONTAINER_NAME	eye_trainer_web	Docker container name
BIND_ADDRESS	127.0.0.1	Bind address (0.0.0.0 to expose publicly)
PORT	50002	Host port

Project Structure

eye-trainer/
├── docker-compose.yaml
├── .env.example
├── nginx/
│   └── default.conf
└── html/
    ├── index.html        # Eye trainer app
    ├── 404.html          # Custom error page
    └── css/
        └── style.css

Usage

1. Start the app and open it in your browser.
2. Choose a movement mode from the dropdown.
3. Adjust speed, ball size, and colour to your preference.
4. Click Hide to collapse the control panel for a cleaner view.
5. Follow the ball with your eyes. Pause any time with the Pause button.

Stopping

docker compose down