Eggcelent Clockwork

GMTK 2026 Countdown

Quick start

Prerequisites

• Git installed.
• Node 24+ installed.

Steps

1. Clone the repository
2. npm install
3. npm run dev

Remember to update game.config.json accordingly.

Building

1. npm run build
2. Build goes to /dist directory

Debugging

This assumes you have VS Code and Chrome installed

• Hit F5 to debug
  • This will launch Vite and Chrome
  • You can now add breakpoints in VS Code
• Hit Shift+F5 twice to stop debugging

Deploying

GitHub

The repository is configured to automatically deploy to Github Pages, you just have to set GitHub Actions as the Build and Deployment source setting in the repo Pages settings.

It will also create new downloads under releases.

Itch

You can configure this repository to automatically deploy and upload releases to Itch. What you have to do is set the BUTLER_CREDENTIALS repository secret and set your Itch username and game name in game.config.json.

System requirements

Web

A modern up-to-date web browser

Windows

• Microsoft Edge 89 or newer
• WebView2 installed (Windows 11 has this preinstalled)

MacOS

• Safari 15 or newer

Linux

• WebKitGTK installed

Notes

Mac

The app is unsigned when built, so you need to tell the user to let it through gatekeeper.

Linux

You may have to mark the games as executable before it will let you run them.

There have been reports of the game freezing, so the web version might be preferred in that case.