docs: add navigation workflow pattern for optimistic: false mutations (#588)

Co-authored-by: Claude <[email protected]>

Author: KyleAMathews

docs/overview.md

@@ -880,6 +880,44 @@ tx.mutate(() => {
 })
 ```
 
+##### Common workflow: Wait for persistence before navigation
+
+A common pattern with `optimistic: false` is to wait for the mutation to complete before navigating to a new page or showing success feedback:
+
+```typescript
+const handleCreatePost = async (postData) => {
+  // Insert without optimistic updates
+  const tx = postsCollection.insert(postData, { optimistic: false })
+
+  try {
+    // Wait for write to server and sync back to complete
+    await tx.isPersisted.promise
+
+    // Server write and sync back were successful - safe to navigate
+    navigate(`/posts/${postData.id}`)
+  } catch (error) {
+    // Show error toast or notification
+    toast.error('Failed to create post: ' + error.message)
+  }
+}
+
+// Works with updates and deletes too
+const handleUpdateTodo = async (todoId, changes) => {
+  const tx = todoCollection.update(
+    todoId,
+    { optimistic: false },
+    (draft) => Object.assign(draft, changes)
+  )
+
+  try {
+    await tx.isPersisted.promise
+    navigate('/todos')
+  } catch (error) {
+    toast.error('Failed to update todo: ' + error.message)
+  }
+}
+```
+
 ## Usage examples
 
 Here we illustrate two common ways of using TanStack DB: