shelf - nesbox/TIC-80 GitHub Wiki
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.
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.
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 -
dirlists 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.
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.
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.