Documentation
This tool works with both Expo and React Native CLI projects. Just install and go.
Some bugs only show up at a certain time, like an offer that ends on Friday. Clock changes the time your app sees, and only your app. Jump a week ahead and see what breaks. Your phone's clock stays the same.
The real Clock tool on a sample app
1 / 8The deal and the fries offer at the top use the app's clock. Right now it matches the phone. Your computer's clock never changes.
Install
npm install @buoy-gg/clockClock shows up in your FloatingDevTools menu on its own. If your app reads the time while it starts up, import it first in your entry file:
// index.js
import "@buoy-gg/clock";
import "expo-router/entry";
// index.js
import "@buoy-gg/clock";
import "expo-router/entry";
How to use it
- Tap +1 hour, day, week or month to jump ahead. Timers that would have gone off during the jump run too.
- Tap Date & Time to type an exact time, like
2026-12-31 23:59or+3d. - Turn on Freeze to stop time. Use Speed to make it run faster. (Pro)
- Tap Use Real Time to go back.
A small strip stays on screen while the time is changed, so you don't forget.
If a screen still shows the old time, it hasn't drawn again yet. Tap Reload App in the tool. The changed time stays through that reload.
With Pro, the changed time also stays when the app restarts or reloads any other way. On the free plan, that puts the app back on real time.
Sign-in tokens
Your app sends a token with its requests to prove who the user is. Tokens run out, and then the app has to get a new one. Clock shows your app's token and how long it has left. It needs the Network tool installed.
Two buttons test the refresh. Both are part of Buoy Pro:
- Jump to Expiry moves the app's time to just before the token ends. Your app should get a new token.
- Fail Next Request makes the next request fail with a 401 ("not signed in"). Your app should get a new token and try again.
Use your app after either one. A line under the token tells you if a new token came. Clock never shows or saves the token itself.
What stays real
Clock changes Date.now(), new Date() and your app's timers. The time zone, animations, native code and your server keep real time. To test something your server checks, use Network overrides instead.
FAQ
What is free?
Jumping ahead, Date & Time and the token row. Freeze, Speed, keeping the time after a restart, the two token tests, the MCP server and Ask Buoy need Pro.
Does this change the time on my phone?
No. Only your app sees the new time.
Can I change the time zone?
No. Change it in the simulator or phone settings.
Can AI agents use it?
Yes. The MCP server has get_clock and clock_action, and Ask Buoy can do it when you ask, like "show me the offers screen 30 days from now". Buoy Desktop has a Clock panel too.