diff --git a/.DS_Store b/.DS_Store
deleted file mode 100644
index 60a98885..00000000
Binary files a/.DS_Store and /dev/null differ
diff --git a/images/usage/use-case-prioritized.png b/images/usage/use-case-prioritized.png
new file mode 100644
index 00000000..5014659a
Binary files /dev/null and b/images/usage/use-case-prioritized.png differ
diff --git a/mint.json b/mint.json
index 5465205b..405f1dc4 100644
--- a/mint.json
+++ b/mint.json
@@ -210,6 +210,7 @@
             "usage/use-case-examples/infinite-scrolling",
             "usage/use-case-examples/offline-only-usage",
             "usage/use-case-examples/postgis",
+            "usage/use-case-examples/prioritized-sync",
             "usage/use-case-examples/custom-write-checkpoints"
           ]
         },
diff --git a/usage/use-case-examples/prioritized-sync.mdx b/usage/use-case-examples/prioritized-sync.mdx
new file mode 100644
index 00000000..19c7b078
--- /dev/null
+++ b/usage/use-case-examples/prioritized-sync.mdx
@@ -0,0 +1,42 @@
+---
+title: "Prioritized Sync"
+description: "In some scenarios, you may want to sync tables using different priorities. For example, you may want to sync a subset of all tables first to log a user in as fast as possible, then sync the remaining tables in the background."
+---
+
+## Overview
+
+The general approach is as follows:
+
+1. Define how many priority types you want - typically only two are needed: "high priority" and "the rest"
+2. Create a sync bucket for each priority type
+3. Use [client parameters](/usage/sync-rules/advanced-topics/client-parameters) to control which priorities you want the client to sync
+
+## Example
+Suppose we have two tables: `lists` and `todos` (as per the standard todolist demo app [schema](/integration-guides/supabase-+-powersync#create-the-demo-database-schema)). Further, suppose we want the sync priority to behave as follows:
+
+1. First, sync all the user's lists, enabling us to render the initial screen in the app
+2. Then, sync the user's todos
+
+Below are the sync rules that will enable this:
+
+```yaml
+bucket_definitions:
+  # always sync high priority tables (first), in this case the user's lists
+  high_priority:
+    parameters: select id as list_id from lists where owner_id = token_parameters.user_id
+    data:
+        - select * from lists where id = bucket.list_id
+  # sync any remaining tables, in this case todo items
+  remaining:
+    parameters: select id as list_id from lists where owner_id = token_parameters.user_id and (request.parameters() ->> 'remaining_tables' = true)
+    data: 
+        - select * from todos where list_id = bucket.list_id
+```
+
+It is recommended to set Client Parameters in the [Diagnostics App](https://github.com/powersync-ja/powersync-js/tree/main/tools/diagnostics-app) to verify functionality at this point:
+
+<Frame>
+  <img src="/images/usage/use-case-prioritized.png"/>
+</Frame>
+
+If everything checks out, you can then proceed to implement the client parameter switching accordingly in your app.
\ No newline at end of file