Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/xXmizzeryXx/zenodeployment/llms.txt

Use this file to discover all available pages before exploring further.

The games page (games.html) is Zeno’s central hub for adding, browsing, and launching browser games. Every game you add is persisted in IndexedDB so the library survives page reloads without re-uploading. Games are served through a Service Worker during play and restored automatically on the next visit.

Import methods

Zeno gives you three ways to bring games into your library. Each method suits a different workflow.

Upload games manually

Drag game folders directly onto the page or use the ADD GAMES modal to load up to five at once.

Import from Git

Paste a GitHub, GitLab, or Forgejo repo URL. Zeno scans for game folders and downloads only what you select.

Import from R2

Iframe games hosted on a public Cloudflare R2 bucket directly — no file download or SW registration needed.

The games grid

All added games appear as cards in a responsive grid. Each card shows the game’s name and icon. The grid supports four size modes — compact, medium, large, and list view — switchable from the filter bar above the grid. A search bar in the top bar filters cards by name in real time. If no games match your query, the grid displays a “NO GAMES FOUND” state with quick-action buttons to clear the search or add more games. Sort options in the filter bar let you order games by default order, A–Z, most recently played, most played, favorites, or top rated.

Recently played row

When you have play history, a RECENTLY PLAYED row appears above the grid. Each entry shows the game’s icon, name, and relative time since last played. Clicking any chip launches that game immediately.

Service Worker status badge

A small dot in the top bar reflects the health of the Service Worker that serves your game files.
Badge stateMeaning
PENDING (grey)The SW is being registered or has not yet responded
SW LIVE (green, pulsing)The SW is active and ready to serve games
SW ERR (pink)The SW failed to register — uploaded games cannot be served
If you see SW ERR, ensure Zeno is served over HTTP or HTTPS and not opened from a file:// URL. Service Workers require a secure context.

Keyboard launcher

Press / anywhere on the games page to open a spotlight-style launcher overlay. Type to filter your game list by name, use the arrow keys to navigate results, and press Enter to launch the highlighted game. Press Ctrl+Enter to open the game’s info sidebar instead. Press Escape or click outside the overlay to dismiss it without launching anything.

Deleting games

Hover any game card to reveal action buttons in the top-right corner. The delete button (pink) removes the game from IndexedDB and sends an UNREGISTER_GAME message to the Service Worker, cleaning up its in-memory file store. Deletion cannot be undone, but you can re-add the game at any time.

Playing games

Playing games

How launching works, the fullscreen modal, SW health checks, and automatic re-registration.

Upload games manually

Required folder structure, drag and drop, and the ADD GAMES modal.

Build docs developers (and LLMs) love