# Shelf — Read Later

A new-tab page that shows everything you've saved to read later, as a
sortable grid or list. No account, no server — everything lives in your
browser's local extension storage.

## How to save something

- **Click the toolbar icon** — saves the page you're currently on.
- **Right-click a page** → "Save page for later"
- **Right-click a link** → "Save link for later" (doesn't need to be open)

A ✓ briefly appears on the icon to confirm the save.

## The shelf (new tab page)

- Toggle between **grid** (cards with thumbnails) and **list** (compact,
  bookshelf-spine style) — top right.
- **Sort** by newest, oldest, title, or site.
- **Search** filters by title, domain, or URL as you type.
- **Archive** tucks an item away without deleting it; "Show archived"
  reveals archived items again.
- **Delete** removes an item, with a 5-second **Undo**.

Thumbnails are captured automatically when you save the *current* page
(a screenshot of what's on screen). Links saved via right-click show a
favicon instead, since the browser hasn't loaded that page yet.

## Install — Chrome / Edge (unpacked)

1. Go to `chrome://extensions` (or `edge://extensions`).
2. Turn on **Developer mode** (top right).
3. Click **Load unpacked** and select this folder.
4. Open a new tab — you should see the Shelf page.

## Install — Firefox (temporary, for testing)

1. Go to `about:debugging#/runtime/this-firefox`.
2. Click **Load Temporary Add-on…**
3. Select the `manifest.json` file inside this folder.
4. Open a new tab. Firefox will ask permission to let the extension
   override the new tab page the first time — allow it.

> Temporary add-ons in Firefox are removed when you close the browser.
> For a permanent install, the extension needs to be signed by Mozilla
> (via [addons.mozilla.org](https://addons.mozilla.org)) or loaded in a
> [Developer Edition / Nightly build](https://www.mozilla.org/firefox/developer/)
> with `xpinstall.signatures.required` set to `false`.

## Notes / things you might want to change

- Storage uses `chrome.storage.local`, so saved links stay on the device
  you saved them on. Swapping the `chrome.storage.local` calls for
  `chrome.storage.sync` in `background.js` and `newtab.js` would sync
  small link lists across your signed-in browsers, but `sync` storage
  has a much smaller quota (~100KB) and doesn't handle thumbnails well —
  not recommended once you have images in the mix.
- Icons in `icons/` are placeholders — swap them for your own artwork
  any time; sizes 16/32/48/128 are already wired up in `manifest.json`.