docs: update multi-tab behavior for web SDK (powersync-docs #552) - #66
Merged
Merged
Conversation
- enableMultiTabs defaults to false on Android, iOS, and Safari - When multi-tab is disabled/unavailable, broadcast channels (v2.1.0+) share sync status, update notifications, and stream subscriptions - Remove inaccurate "only oldest tab syncs" description Source: powersync-docs#552
michaelbarnes
requested changes
Aug 18, 2026
michaelbarnes
left a comment
michaelbarnes
left a comment
Collaborator
There was a problem hiding this comment.
@bean1352 could you check if these changes still valid seeing that the flags got folded up?
…Factory The flags object was removed from the SDK. useWebWorker and enableMultiTabs are now properties of the database config object, not flags. WASQLiteOpenFactory is no longer needed — vfs is passed directly in database. Remove debugMode reference (no longer in the SDK). Addresses review comment on PR #66.
Collaborator
Author
|
Good catch. The Fixed in the latest commit:
The core behavioral content (multi-tab platform defaults, broadcast channel fallback) from this PR is still accurate. Generated by Claude Code |
michaelbarnes
changed the title
joshuabrink
approved these changes
Sep 10, 2026
michaelbarnes
approved these changes
Sep 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Source docs PR: powersync-ja/powersync-docs#552
What changed in docs
The multi-tab support section in the JavaScript Web SDK reference was rewritten. The
enableMultiTabsflag now defaults tofalseon Android, iOS, and Safari (not justtrueeverywhere), and a new "Behavior Without Shared Workers" section documents the broadcast channel fallback introduced in v2.1.0.Skill updates in this PR
skills/powersync/references/sdks/powersync-js.md: Updated theenableMultiTabscode comment to note the platform-specific default, and rewrote the multi-tab behavior description to cover the broadcast channel fallback when shared workers are disabled or unavailable.Notes for reviewer
The previous description said "only the oldest tab syncs" when multi-tab is disabled, which is no longer accurate since v2.1.0 added broadcast channels for sharing sync status, watched query update notifications, and sync stream subscriptions across tabs. The updated text covers both paths: shared-worker (enabled) and broadcast fallback (disabled/unavailable).
No changes to other skill files were needed. The AGENTS.md install section still lists
@journeyapps/wa-sqlite@latestas a peer dependency, but its removal as a peer dependency (as of v2.1.0) came from a separate docs PR (#550) and is out of scope for this PR.Generated by Claude Code