shelf - nesbox/TIC-80 GitHub Wiki

Shelf

Added in the 1.5 line.

The Shelf is the signed-in player's private cart storage on tic80.com. SURF lists it at the site root as the Shelf folder, next to the site's own folders and the Likes folder.

Signing in

login

Native builds start a pairing: on desktop and Android the console prints a link with the code embedded, so one click finishes it; browserless builds print the link and a separate code to enter on the site. The browser IDE opens the site's sign-in instead, because there the site session is already the identity. In native builds logout removes the stored token; the browser IDE signs out on the site.

Native builds keep the account token in .local/account.json, outside the per-build folder, so it survives a TIC-80 update. The web IDE has no token: the site session is the identity.

Using the shelf

With SURF inside the Shelf folder, the console's file commands act on the shelf:

  • save <name> uploads the current cart to the shelf
  • load <name> opens a cart from the shelf
  • del <name> removes it
  • dir lists the shelf's carts

The shelf is flat: it takes cart names, not nested folders. Saving prints the account's usage, and a full shelf answers with a quota message. Without a network the shelf reports that it is offline; without a sign-in it asks for login.

Likes

The Likes folder in SURF is the list of carts you have +1'd. Press X on a site cart in SURF to like it, Y to open its page in the browser. Likes need a sign-in, like the shelf does.

Availability

The shelf is part of native builds with editors or SURF and of the tic80.com web IDE. The editorless exports and the bare-metal builds do not carry it.

⚠️ **GitHub.com Fallback** ⚠️