Skip to content

peterpeterparker/cycles.watch

Repository files navigation

Cycles.watch

Cycles.watch shows the current cycle balance of your canisters on the Internet Computer and monitors their status over time. It periodically refreshes the data and displays a local notification if any canister drops below a defined threshold.

It also offers an ICP-to-cycles swap feature to top up your canister using an external wallet 👛. Currently, this is supported through OISY .

The dapp is built with Juno 👨‍💻.

[!NOTE] Notifications are shown only while the app is open — even if it's running in the background. These are not push notifications.

Hacking

Want to contribute or run it locally? Here's how.

Prerequisites

npm install -g @junobuild/cli

Clone the repo

git clone https://github.com/peterpeterparker/cycles.watch
cd cycles.watch
npm ci

Run locally

Start local development

In one terminal, start the Juno emulator:

juno dev start

In another terminal, start the frontend:

npm run dev

This will launch the app in development mode and connect it to your local emulator environment.

The frontend starts on port 5173. You’ll need the local Juno Console UI to create canisters — it’s available on port 5866.

License

Cycles.watch is released under the GNU Affero General Public License Version 3 (AGPLv3) or any later version. See GNU-AGPL-3.0 and COPYING for more details.