Previews
Every dev server a thread starts on Keko Cloud or your server gets a readable link of its own
When a thread on Keko Cloud starts a server that listens on a port, the server gets an address of its own, such as
https://quick-scout-4821.supercolony.run. The name is given when the port first opens and stays the same for the
machine's life, so links keep working while the thread does.
Threads on your server get previews the same way once it's set up with
keko setup --previews. A preview there reaches only a server started in one of its threads' worktrees or
projects, never anything else running on the machine, and Keko reaches it through the machine's own outbound
connection, so no port is opened. A thread on This Mac runs its dev server on your Mac, where you open it on
localhost as usual.
Open a preview
The thread's header shows its previews: the port, or how many there are. The panel has, for each one:
- Open preview: in the work pane's browser.
- Open in tab: in a tab of its own in the app.
- Open in browser: in your default browser.
- Copy share link, and the share links you've made, with Revoke.
Opening a preview whose Keko Cloud machine is stopped starts the machine. The page says it's starting and reloads until the server answers. A preview on your server answers while the server is online.
Who can open it
A preview opens for the thread's owner. A browser that isn't signed in is sent through Keko's sign-in with GitHub first, then back to the page.
A share link lets someone else open it without an account. Each link works once, for whoever opens it first, and expires after an hour unless it's used. Revoking it ends the link and the access it gave.
When a thread is archived or its machine is removed, its previews answer "This preview has ended". Unarchiving the thread brings them back. A server's previews end with their thread, and when the server is removed from your account.
Why a separate domain
Previews run whatever code the thread wrote, so they live on supercolony.run, a domain apart from
keko.run. A preview page can't read or use your Keko sign-in.