A fullscreen countdown for speakers at talks, meetups, and conferences. Color-coded stages warn you before time runs out, so you can pace the presentation without glancing at a watch.
- Large, readable display — built for projectors and stage monitors
- Two warning thresholds — amber warning and red final alert, by time or percentage of total duration
- Visual states — background color reflects idle, running, warning, danger, and paused
- Automatic dark mode — settings and dialogs follow your operating system theme
- Quick presets — common talk lengths from 5 to 120 minutes
- Optional stopwatch — track elapsed time alongside the countdown
- Keyboard control —
Spaceto start/pause,Escto reset while running - Persistent settings — preferences saved in the browser
Requirements: Node.js 24 or newer
git clone https://github.com/hlavacm/events-timer.git
cd events-timer
npm install
npx playwright install
npm run devOpen http://localhost:5173.
| Command | Description |
|---|---|
npm run dev |
Local development with hot reload |
npm run build |
Production build into dist/ |
npm run preview |
Preview the production build locally |
npm run lint |
Run ESLint |
npm run typecheck |
Run TypeScript check |
npm test |
Typecheck, unit tests, and end-to-end tests |
npm run test:ci |
Typecheck, coverage, and end-to-end tests |
npm run test:unit |
Vitest unit tests |
npm run test:coverage |
Unit tests with coverage report |
npm run test:e2e |
Playwright end-to-end tests |
npm run screenshot |
Rebuild and refresh the README screenshot |
Vue 3 · TypeScript · Vite · Pinia · Tailwind CSS · Vitest · Playwright · lucide-vue-next
The site is published to GitHub Pages via the Deploy to GitHub Pages workflow.
On every push to master, GitHub Actions:
- installs dependencies with Node.js 24
- runs lint and unit tests
- runs
npm run build - deploys the
dist/output as a Pages artifact
To enable this in the repository settings, set Pages → Build and deployment → Source to GitHub Actions.
For a local production build:
npm run buildDo not commit production build output by hand — GitHub Actions builds and deploys it from source.
BSD 3-Clause License · Copyright (c) Martin Hlaváč