Skip to content

Session snapshots, Chrome Web Store auto-publish, and landing updates - #3

Merged
YarooqH merged 3 commits into
masterfrom
feat/session-snapshots
Oct 8, 2026
Merged

YarooqH merged 3 commits into
masterfrom
feat/session-snapshots

Conversation

@YarooqH

@YarooqH YarooqH commented Oct 8, 2026

Copy link
Copy Markdown
Owner

Summary

Session snapshots (v1.3.0). If you close the wrong window, or a crash or shutdown loses your session, the tabs are no longer gone for good.

  • Every window with 2+ tabs is saved the moment it closes.
  • Periodic snapshots run every 1h / 3h / 6h (default) / 24h / 7d, with configurable retention. Unchanged sessions are skipped.
  • The session that was open before the browser restarted is archived when the browser starts again.
  • A new Sessions tab in the popup restores a snapshot into a new window. Tab order, pinned tabs and tab groups (name, color, collapsed state) come back as they were. With RAM Saver on, restored background tabs go to sleep straight away.
  • New Settings section: toggles, interval and retention, plus JSON export, import and delete-all.
  • Snapshots are stored only in chrome.storage.local, separate from settings, so "Reset to Defaults" keeps them.

Chrome Web Store auto-publish. Uses Chrome Web Store API v2; v1 is retired on 2026-10-15.

  • On every PR: validate, syntax-check and package the extension. If shipped files changed, the version must be higher than master's.
  • On merge to master: if manifest.json is newer than the store version, upload and submit for review, then create a GitHub release with the zip attached.
  • Auth uses a service account key or an OAuth refresh token. Until the chrome-web-store environment secrets exist, the publish job skips with a warning. Setup: docs/PUBLISHING.md.

Landing page and docs

  • New story step 04 and a 4th "How it works" card for restoring windows; updated hero, meta and privacy copy.
  • Keyboard shortcut labels now match manifest.json (Alt+Shift+T opens the popup, Alt+Shift+S stacks the window).
  • Mobile: no more sideways scrolling from 320 to 1280px. Below 480px the header drops the GitHub icon button; the hero and footer still link to GitHub.
  • README: snapshots section with a screenshot, plus release instructions.

Before merging

  • Add the chrome-web-store environment secrets (docs/PUBLISHING.md), or merge without them; publishing then just skips.
  • In the Developer Dashboard → Privacy practices, add a justification for the new unlimitedStorage permission and refresh the store description and screenshots. The API can't update the listing.

Testing

  • Chromium + Playwright, unpacked extension: 27 checks covering window-close capture, pins and groups, restore order, placeholder tab removal, the previous-session archive, import sanitization, alarm scheduling, and settings not wiping snapshots.
  • Sleep-on-restore checked in a plain Chromium launch (Playwright-driven Chromium exits on any tabs.discard, including the existing RAM Saver): 5/5 background tabs slept, the active tab stayed awake, URLs and groups were intact.
  • cws-publish.mjs against a local mock of the v2 API: 12/12 scenarios (service account JWT and refresh token, skip cases, async upload polling, pending-review handling, credential errors).
  • Landing page: production build passes; screenshots in dark and light; horizontal overflow measured at 320 / 360 / 375 / 414 / 480 / 768 / 1280px.

🤖 Generated with Claude Code

YarooqH and others added 3 commits October 8, 2026 07:39
Closing the wrong window (or losing a session to a crash) used to lose every
tab in it. TabStack now keeps a persisted mirror of each open window and:

- saves a window the moment it closes (2+ tabs)
- takes periodic snapshots (1h/3h/6h/24h/7d, configurable retention)
- archives the previous browser session on the next start

A new Sessions tab in the popup restores a snapshot into a new window with
tab order, pinned tabs and tab groups (title, color, collapsed) intact, and
puts restored background tabs to sleep when RAM Saver is on. Settings adds
toggles, interval/retention and JSON export/import.

Snapshots live in chrome.storage.local outside the settings keys, so
"Reset to Defaults" keeps them. Adds unlimitedStorage for large sessions
and updates the privacy policy, which said tab URLs were never stored.

Bumps version to 1.3.0 and shows the real version in the popup header.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds a workflow that validates and packages the extension on every PR and,
on merge to master, uploads it through the Chrome Web Store API v2 and
submits it for review when manifest.json has a newer version than the store.
The v1 API is retired on 2026-10-15.

- PRs that change shipped files must bump the manifest version
- supports a service account key or an OAuth refresh token
- skips with a warning until the chrome-web-store secrets exist
- manual runs can stage the publish or replace a pending submission
- creates a GitHub release with the submitted zip

docs/PUBLISHING.md covers the one-time credential setup.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- landing: add story step 04 and a 4th "How it works" card for restoring
  closed windows; update hero and meta copy and the privacy table
- landing: correct the keyboard shortcut labels to match manifest.json
- landing: stop horizontal scrolling on phones (header actions, install
  cards and the demo's telemetry badge no longer exceed the viewport)
- landing: wrap the "How it works" grid to 2/1 columns on smaller screens
- README: document session snapshots and the release pipeline

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@YarooqH
YarooqH merged commit 2cdfc73 into master Oct 8, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant