Repository navigation
Releases
Surffish v0.2.0-beta.9
Surffish v0.2.0-beta.9
Surffish now handles fullscreen end to end: pages fill the window, and both native and video fullscreen hide the toolbar, sidebar, and window controls.
New
- Sidebar layout: the "Sidebar pushes page" toggle and the "Animation" (resize/slide) select are now one Layout control in Settings → Sidebar & bookmarks bar, with Resize, Slide, and Float options (Float overlays the page without shifting it).
Fixed
- Fullscreen pages now fill the window instead of leaving the toolbar inset (#343).
- The toolbar and sidebar stay hidden during video fullscreen (#342).
- The macOS window controls are hidden in native fullscreen (#341).
- Native fullscreen shows the page content only (#340).
- The sidebar rail is hidden during fullscreen and its hover is stabilized (#339).
- The sidebar's hover-close guard holds during native motion (#338).
- When a page's video expands to fill the window, the sidebar rail collapses and the page stays clickable.
Packaging
- Still unsigned and not notarized. If macOS says it's damaged, run
xattr -cr /Applications/Surffish.appon a copy you got from the official release.
Surffish v0.2.0-beta.8
Surffish v0.2.0-beta.8
Fixes Bramble update checks and installation after the upstream project moved its GitHub repository, alongside a compatible dependency refresh.
Fixed
- Bramble update checks and installation: Use the new
bramble-sh/bramblerepository for release metadata and installer assets, avoiding the unexpected-redirect error that prevented Check for updates and Install (#337).
Dependency baseline
- Refresh compatible dependencies, including Electron
46.0.0-alpha.11, DOMPurify3.4.18, andtldts-experimental7.5.4.
Packaging
- Expected asset: Apple silicon macOS ZIP,
Surffish-0.2.0-beta.8-mac-arm64.zip. The app remains unsigned and not notarized; there are no Windows or Linux release assets.
Surffish v0.2.0-beta.7
Surffish v0.2.0-beta.7
A sidebar and tab feel update on top of beta.6.
Features
- Resize push: The hover panel can now resize the pushed page instead of overlapping it, with a new Sidebar animation setting (#332). The resize push re-lays out once and slides in between, so it stays smooth (#333).
- Rail pins condensed: Pinned tabs on the collapsed rail now show as the first pin plus a "+N" chip instead of an overlapping stack (#334).
- Card-only swipe: Back/forward trackpad swipes leave the page in place and only show the hover card. Settings › Appearance › "Swipe slides page" brings back the sliding page on macOS; it is off by default (#335).
- Slept tab titles: Sleeping tabs keep their real page title instead of showing only the hostname, and titles are saved with the session so they come back after a restart before tabs load (#336).
Dependency baseline
- No dependency changes since beta.4; see the beta.4 notes.
Packaging
- Expected asset: Apple silicon macOS ZIP,
Surffish-0.2.0-beta.7-mac-arm64.zip. The app remains unsigned and not notarized; there are no Windows or Linux release assets.
Surffish v0.2.0-beta.6
Surffish v0.2.0-beta.6
A sidebar polish follow-up to beta.5, focused on the hover panel and its frame staying in sync with the page.
Fixes
- Collapsing drops the panel ghost: Collapsing the sidebar no longer leaves an outgoing panel ghost behind while the rail settles (#327).
- Labels clip during hover expansion: Tab labels are clipped to the panel's edge while the hover panel expands, so text no longer spills past the sidebar onto the page (#328).
- First-frame native hover reveal: The native hover reveal starts on its first frame instead of a frame late, so the panel and its contents open together (#329).
- macOS sidebar backdrop over pages: The sidebar backdrop now lives in its own web contents view on macOS, so it sits correctly over WebContentsView pages (#330).
- Waking tab under the pushed panel: Clicking a sleeping tab while the hover panel is open no longer shows its snapshot at the unpushed spot with panel labels drawn over it. The snapshot is placed at the pushed page position and slides with the page card (#331).
Dependency baseline
- No dependency changes since beta.4; see the beta.4 notes.
Packaging
- Expected asset: Apple silicon macOS ZIP,
Surffish-0.2.0-beta.6-mac-arm64.zip. The app remains unsigned and not notarized; there are no Windows or Linux release assets.
Surffish v0.2.0-beta.5
Surffish v0.2.0-beta.5
A focused follow-up to beta.4 fixes the New Tab handoff from the collapsed sidebar rail.
Fixes
- Collapsed-rail New Tab transition: When New Tab is opened from the collapsed rail, the content surface now settles its sidebar morph instead of animating an outgoing panel ghost. This prevents a full-width tab label from flashing or overlapping the New Tab card while the rail is collapsed; the card keeps its normal width transition.
Regression coverage
- The Electron smoke test now clicks New Tab from the collapsed rail and samples the visible handoff frame by frame, checking that panel labels do not paint while the rail is collapsed or beyond the card, and that no outgoing panel ghost appears.
Dependency baseline
- Beta.4 introduced the continuous browser frame and documented the Electron and dependency updates. This focused follow-up changes no dependency versions; see the beta.4 notes for that baseline.
Packaging
- Expected asset: Apple silicon macOS ZIP,
Surffish-0.2.0-beta.5-mac-arm64.zip. The app remains unsigned and not notarized; there are no Windows or Linux release assets.
Surffish v0.2.0-beta.4
Surffish v0.2.0-beta.4
Surffish now has a continuous browser frame around the toolbar and sidebar, with live pages and New Tab displayed as inset cards. Pinned sites move more smoothly between the compact rail and expanded sidebar. This release updates Electron to 46.0.0-alpha.10.
Added and improved
- Integrated frame: macOS uses native vibrancy for a continuous toolbar/sidebar surface. Supported Windows 11 22H2+ builds use Mica when Electron exposes the API; other configurations use a solid fallback. Appearance settings add a frame-transparency control for the macOS glass frame.
- Inset page cards: Live pages sit in opaque, rounded cards beside the docked sidebar or collapsed rail. New Tab is a rounded card on the same frame ground; with Sidebar pushes page enabled, the card moves aside as the sidebar opens, and the New Tab customization panel aligns to the card’s right edge.
- Pinned-site rail: Pins remain in one ordered cluster. The first pin stays anchored while the remaining pins glide smoothly as the sidebar collapses and expands.
Dependencies and CI
- Electron
46.0.0-alpha.10, Vite8.3.8,@vitejs/plugin-react6.3.0, andtldts-experimental7.4.26. - Electron smoke coverage checks frame and page geometry, New Tab layout, sidebar reveals, and pin motion. Hosted Linux smoke setup now installs FFmpeg and retries package installation.
Packaging
- Apple silicon macOS ZIP:
Surffish-0.2.0-beta.4-mac-arm64.zip. The app is unsigned and not notarized; there are no Windows or Linux release assets. If macOS reports the app as damaged, runxattr -cr /Applications/Surffish.appon a copy downloaded from the official release.
Surffish v0.2.0-beta.3
Surffish v0.2.0-beta.3
Surffish keeps Bramble autofill working with Bramble 1.33 and later, remembers half-typed address bar text per tab, stops sidebar icons fading under a text selection, smooths sidebar transitions, hides the title bar in fullscreen, and moves to Electron 46.0.0-alpha.7.
Fixed
- Address bar drafts: text typed into the address bar and not submitted now stays with its tab; switching to another tab shows that tab's own address, and switching back restores the draft with the caret where it was. On a New Tab the address bar gets the keyboard back. Esc, submitting, navigating or closing the tab drops the draft (#321)
- Sidebar icons under a selection: a drag-select or Cmd+A that runs over the sidebar no longer selects the tab rows and pinned site icons like text, so the pinned icons no longer look faded; search and rename fields in the sidebar still select text (#322)
- Collapsed sidebar rail: the rail keeps only the sidebar pin, in the same spot as the panel's pin, instead of New Tab / New Private Tab / Settings buttons that the revealed panel covered (#320)
- Bramble autofill: Bramble 1.33.0 and 1.34.0 builds stage again instead of being refused with "unsupported autofill click guard"; the picker settle delay adapter recognises Bramble's new inlined guard as well as the older form (#316)
- Update badge: choosing Remind Later no longer lets a stale startup update check bring the badge back (#317)
- Fullscreen title bar: the browser title bar stays hidden in fullscreen until the pointer reaches the top edge (#315)
- Sidebar rail and panels: the persistent rail and panel layout transition more smoothly between views
- Managed SSH tunnels: reconnect after sleep or network drops
- Pinch-zoom panning: no longer triggers browser-history navigation
- Ad filtering and background tabs: improve resource/cache handling and ordering
- Toolbar and windows: improve toolbar and window behavior
CI
- The release workflow falls back to a GitHub-hosted
macos-26runner when the self-hosted Mac is offline, retries the Bun download, and skips electron-builder's native rebuild (#319) - CI falls back to GitHub-hosted runners when the self-hosted runners are offline (#314)
- Timing-sensitive smoke checks (site-actions menu, mini-window throw, New Tab rail wakeups) tolerate slower hosted runners (#317)
- Compatible dependencies are refreshed; Electron updates to
46.0.0-alpha.7(#317), and the built-in PDF engine updates to6.5.438 - Read Aloud sentence-highlight coverage exercises Electron's user-origin CSS cleanup fix
Packaging
- Apple silicon zip only, unsigned and not notarized. If macOS reports the app is damaged, run
xattr -cr /Applications/Surffish.appon a copy downloaded from the official release
Surffish v0.2.0-beta.2
Surffish v0.2.0-beta.2
Surffish recovers its SOCKS5 tunnel after sleep or a network drop, leaves pinch-zoomed pages to two-finger panning, and moves to Electron 46.0.0-alpha.2, alongside the earlier settings-search and display-scale improvements.
New
- Settings search: searches for “translate” and “translation” surface the Languages page and its Target language control, while compact layouts keep Settings navigation usable (#306)
Fixed
- Managed tunnel reconnect: the built-in client and system OpenSSH rebuild the SOCKS5 tunnel themselves after a failure. Network-level errors (connection resets, timeouts, an unreachable host, a dropped link, an unready SSH agent) retry on a one-to-thirty-second backoff, and the tunnel also rebuilds on wake from sleep, so a session killed by sleep recovers without re-saving Settings; Settings shows “Reconnecting to SSH server…” with the last error while an attempt is pending (#312)
- Pinch-zoom swipes: back/forward swipes are refused while a page’s visual viewport is zoomed past 1×, so panning a magnified page with two fingers no longer navigates history at random; pinching back out restores swipes. Browser zoom, which reflows rather than pans, is untouched
- Capture scaling: screenshot crops, tab thumbnails, sidebar backdrops, and wake-snapshot limits preserve the right bitmap scale on 1×, Retina, and fractional-scale displays (#304)
- Page drag regions: browser tabs and Glance no longer receive an obsolete page-level no-drag override; Electron 46 now handles draggable regions in child web contents (#305)
CI
- Browser tab shortcuts, sidebar chrome, and mini-window native menus are split into focused modules, with regression tests and Electron smoke coverage (#308, #309, #310)
- Compatible project dependencies are refreshed (#311); Electron moves from 46.0.0-alpha.1 to 46.0.0-alpha.2
- A git pre-commit hook formats staged files with bun fmt, so an unformatted file no longer reaches the repository to fail the CI format check
Packaging
- Apple silicon zip only, unsigned and not notarized. If macOS reports the app is damaged, run
xattr -cr /Applications/Surffish.appon a copy downloaded from the official release - A rebuild of this release was published as
Surffish-0.2.0-beta.2-2-mac-arm64.zip(the Homebrew Cask installs it) with the fixes above; the original zip remains on the release, because the published npm launcher package pins its checksum
Surffish v0.2.0-beta.1
Surffish v0.2.0-beta.1
Surffish's first beta, built on the Electron 46 alpha, and the first pre-release on the beta channel.
New
- Beta channel: the first pre-release, v0.2.0-beta.1, is published on the beta channel. Pre-releases are offered ahead of the latest stable, and the update check surfaces them when the beta channel is enabled.
Fixed
- Clearing site data no longer asks the engine to clear WebSQL storage, which the Electron 46 engine no longer clears. Cookies, storage and cache are still cleared as before.
Packaging
- Apple silicon zip only, unsigned and not notarized. If macOS reports the app is damaged, run
xattr -cr /Applications/Surffish.appon a copy downloaded from the official release
Surffish v0.1.35
Surffish v0.1.35
Surffish connects managed SSH tunnels with a built-in SSH client, adds a System OpenSSH option, moves connection settings to their own tab and gives the macOS app its own executable identity.
New
- Built-in SSH client: managed SSH tunnels now connect with an in-app SSH client that reads
~/.ssh/config(IdentityFile, Port, User, Include, simple Match rules), the default keys in~/.ssh,known_hostsand ssh-agent, and explains failed authentication. Non-default ports work without the systemsshbinary. (527bffc, 3b6f613, bf218fe, a1640e4, de1719b) - SSH client choice: Settings → Connection → SSH client switches between Built-in (default) and System OpenSSH, which runs
/usr/bin/sshwith the full SSH configuration and agent for ProxyJump, ProxyCommand, Match exec, certificates and security keys. Changing it restarts the tunnel on Save. (#303) - Connection settings: the SOCKS5 proxy, managed SSH tunnel, local-network bypass, kill switch, shared listener activity and network rules moved from General to a new Settings → Connection section. Settings search, the command palette (Settings: Connection) and
surffish://settings?section=connectionlead there; older links to General → Connection redirect. (#303)
Fixed
- macOS now treats Surffish as its own app for per-app privacy settings such as Local Network access, instead of sharing the identity every Electron app ships with. (#302)
CI
- Fixed the settings-search smoke index reader, the knip config and the app-payload test after the formatter switch; added a macOS UUID test build workflow. (#302, #303)
Packaging
- The main executable gets a Surffish-specific LC_UUID and the app is re-signed ad hoc after packaging. macOS may ask again once for permissions such as Local Network. (#302)
- Apple silicon zip only, unsigned and not notarized. If macOS reports the app as damaged, run
xattr -cr /Applications/Surffish.appon a copy downloaded from the official release.