Phase Countdown

A simple, responsive multi-phase countdown timer for web and presentations.

Features

• Multiple Phases: Define as many phases as you want, each with a custom title and duration (hours/minutes).
• Configurable Start Time: Set a start date/time for the countdown.
• Live Timer: Displays the current phase, time remaining, and progress bar.
• Next Phase Preview: Optionally show the next phase below the timer.
• Responsive Design: Works well on desktop, tablet, and mobile devices.
• Presentation Mode: "Go Fullscreen" button hides all configuration UI for a clean display (great for events).
• Persistent State: Phases and start time are saved to your browser (localStorage).
• Docker-Ready: Simple to self-host.

Usage

1. Open the app:
   Open index.html in your browser, or deploy to any static file server.

2. Set up your phases:
   Add phases using the form:

   • Enter a title (optional).
   • Specify hours and/or minutes.
   • Click Add Phase.
   • You can edit or delete future phases. Running or completed phases cannot be changed.

3. Set the start time:
   Pick a date and time, then click Save & Start.

4. Presentation mode:

   • Click Go Fullscreen for a clean, distraction-free timer display.
   • Or, add ?present=1 or #present to the URL.
   • Press P to toggle presentation mode.

5. Reset:
   Use the Reset button to clear all data and start fresh.

Customization

• Show Next Phase:
  Use the checkbox to toggle whether the next phase is displayed under the timer.

• URL Parameters:

  • ?start=... — Set the start time via URL (ISO or local datetime).
  • ?present=1 or #present — Launch in presentation mode.

Development

• All logic is in script.js.
• Styles are in styles.css.
• The UI is pure HTML/CSS/JS—no dependencies.

Self-hosting (Docker)

1. Build an image:

   docker build -t phase-countdown .

2. Run:

   docker run -d -p 8080:80 phase-countdown

3. Open http://localhost:8080

(Supply your own Dockerfile as needed for static serving, e.g., using nginx:alpine.)

License

MIT

---

Built for simple phased countdowns — perfect for workshops, hackathons, and events!