New Sync Streams navigation

[benitav]

Focus the current "Sync Streams/Rules" section in the sidebar on Sync Streams only; contain Sync Rules content in the "Sync Rules (legacy)" section.

Previous nav:

Sync Streams & Rules
├── Overview                              (sync/overview)
├── Sync Streams
│   ├── Quickstart                        (sync/streams/overview)
│   ├── Using Parameters
│   ├── Writing Queries
│   ├── Common Table Expressions (CTEs)
│   ├── Bucket Count
│   ├── Examples & Demos
│   ├── Client-Side Usage
│   └── Migrating from Sync Rules         (sync/streams/migration)
├── Sync Rules (Legacy)
│   ├── Overview & Key Concepts
│   ├── Organize Data Into Buckets
│   ├── Global Buckets
│   ├── Parameter Queries
│   ├── Data Queries
│   ├── Many-to-Many and Join Tables
│   └── Client Parameters
├── Type Mapping
├── Supported SQL
│   ├── Guide
│   ├── Grammar Reference (Sync Streams)
│   └── Grammar Reference (Sync Rules)
└── Advanced
    ├── Overview
    ├── Reducing Buckets
    ├── Prioritized Sync
    ├── Client ID
    ├── Case Sensitivity
    ├── Compatibility
    ├── Storage Version 4
    ├── Sync Data by Time
    ├── Schemas and Connections
    ├── Multiple Client Versions
    ├── Partitioned Tables (Postgres)
    └── Sharded Databases

New nav:

Sync Streams                              ← group renamed from "Sync Streams & Rules"
├── Overview                              ← sync/streams/overview, was titled "Quickstart"; sync/overview deleted
├── Quickstart                            ← new page (sync/streams/quickstart)
├── Usage                                 ← new group
│   ├── Writing Queries                   ← now before Using Parameters
│   ├── Using Parameters
│   ├── Common Table Expressions (CTEs)
│   ├── Bucket Count
│   ├── Client-Side Usage
│   ├── Prioritized Sync                  ← moved from Advanced
│   └── Examples & Demos                  ← now after Client-Side Usage
├── Reference                             ← renamed from "Supported SQL"
│   ├── Supported SQL                     ← sidebar title was "Guide"
│   ├── Grammar Reference
│   └── Type Mapping                      ← moved from top level
├── Advanced
│   ├── Overview
│   ├── Reducing Buckets
│   ├── Client ID
│   ├── Case Sensitivity
│   ├── Compatibility
│   ├── Storage Version 4
│   ├── Sync Data by Time
│   ├── Schemas and Connections
│   ├── Multiple Client Versions
│   ├── Partitioned Tables (Postgres)
│   └── Sharded Databases
└── Sync Rules (Legacy)                   ← moved to the bottom
    ├── Migrate to Sync Streams           ← moved from Sync Streams section
    ├── Overview & Key Concepts
    ├── Organize Data Into Buckets
    ├── Global Buckets
    ├── Parameter Queries
    ├── Data Queries
    ├── Many-to-Many and Join Tables
    ├── Client Parameters
    └── Grammar Reference (Sync Rules)    ← moved from Supported SQL

This also updates the migration guide to conform to our writing and style standards (e.g. lessen offline-first framing), improved the flow into a clear "use the tool" step and then "adopt more Sync Streams functionality later" step, and added more practical examples.

Also see #655 for moving more sync rules content into the self-contained "Sync Rules (legacy)" section.

🤖 Claude Code helped implement most of these updates while I reviewed and polished manually.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
powersync	🟢 Ready	View Preview	Sep 18, 2026, 2:59 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[claude]

Reviewed the added/modified content against the writing standards. Found a broken in-page anchor and a few technical-accuracy points needing verification (posted inline). Note: I couldn't run Vale or the Mintlify broken-links check in this environment, so those checks are still outstanding.