Documentation

PWA & Notifications

Foosball Leaderboard is a Progressive Web App (PWA) — you can install it on your phone's home screen and use it like a native app, including receiving push notifications.

Installing the app

On iOS (Safari)

  1. Open the app in Safari on your iPhone or iPad
  2. Tap the Share button (the box with an arrow)
  3. Scroll down and tap Add to Home Screen
  4. Give it a name and tap Add

On Android (Chrome)

  1. Open the app in Chrome on your Android device
  2. Tap the three-dot menu in the top right
  3. Tap Add to Home Screen (or Install App)
  4. Confirm the installation

On desktop (Chrome / Edge)

Look for the install icon in the browser's address bar and click it. On some browsers it appears as a small screen with a download arrow.

The app may also show an Install App banner automatically the first time you visit.

Why install it?

  • Faster — installed PWAs load faster with service worker caching
  • Full screen — runs without the browser's address bar, feeling like a native app
  • Push notifications — receive alerts even when you don't have the app open
  • Home screen shortcut — quick access directly from your device's home screen

Push notifications

Push notifications let the app alert you about important events even when you're not actively using it.

Enabling notifications

The first time you open the app after installing it, you'll be prompted to enable notifications. You can also enable them from Settings → Notifications at any time.

What you get notified about

  • Looking for Players — when someone in your group posts an LFP beacon
  • Weekly Tournaments sign-up — reminder when the weekly tournament opens for registration
  • Achievement unlocked — when you earn a new achievement
  • Match recorded — optional notification when a match involving you is recorded

Disabling notifications

Go to Settings → Notifications to toggle specific notification types on or off. You can also revoke permission entirely from your device's browser settings.

Wake Lock during live matches

When you're using Live Match Tracking, the app requests a Wake Lock — this keeps your screen on so it doesn't lock mid-game while the phone sits on the table as a scoreboard. The lock is released automatically when the match ends.