From 96b2c5d448274c9111674d0797e5fa65fd91b304 Mon Sep 17 00:00:00 2001
From: ymc9 <104139426+ymc9@users.noreply.github.com>
Date: Thu, 20 Nov 2025 10:29:49 -0800
Subject: [PATCH] doc: v3 release beta.25

---
 versioned_docs/version-3.x/reference/cli.md | 26 +++++++++++++++++++++
 versioned_docs/version-3.x/samples.md       |  5 ++++
 2 files changed, 31 insertions(+)

diff --git a/versioned_docs/version-3.x/reference/cli.md b/versioned_docs/version-3.x/reference/cli.md
index 6c68a5e0..73c8101b 100644
--- a/versioned_docs/version-3.x/reference/cli.md
+++ b/versioned_docs/version-3.x/reference/cli.md
@@ -26,6 +26,7 @@ Commands:
   info [path]         Get information of installed ZenStack packages.
   init [path]         Initialize an existing project for ZenStack.
   check [options]     Check a ZModel schema for syntax or semantic errors.
+  format [options]    Format a ZModel schema file.
   help [command]      display help for command
 ```
 
@@ -112,6 +113,8 @@ Options:
   --force              skip the confirmation prompt
   --migrations <path>  path that contains the "migrations" directory
   -h, --help           display help for command
+
+If there is a seed script defined in package.json, it will be run after the reset. Use --skip-seed to skip it.
 ```
 
 #### migrate deploy
@@ -178,6 +181,7 @@ Options:
 
 Commands:
   push [options]  Push the state from your schema to your database
+  seed [options]  Seed the database
   help [command]  display help for command
 ```
 
@@ -198,6 +202,28 @@ Options:
   -h, --help          display help for command
 ```
 
+#### db seed
+
+```bash
+Usage: zen db seed [options]
+
+Seed the database.
+
+Options:
+  --no-version-check  do not check for new version
+  -h, --help          Show this help message
+
+Seed script is configured under the "zenstack.seed" field in package.json.
+E.g.:
+{
+    "zenstack": {
+        "seed": "ts-node ./zenstack/seed.ts"
+    }
+}            
+
+Arguments following -- are passed to the seed script. E.g.: "zen db seed -- --users 10"
+```
+
 ### info
 
 Get information of installed ZenStack packages.
diff --git a/versioned_docs/version-3.x/samples.md b/versioned_docs/version-3.x/samples.md
index 2e2a6f1a..666ba4b8 100644
--- a/versioned_docs/version-3.x/samples.md
+++ b/versioned_docs/version-3.x/samples.md
@@ -13,3 +13,8 @@ https://github.com/zenstackhq/zenstack-v3/tree/main/samples/blog
 
 A simple TypeScript application that demonstrates how to model a minimum blog app and how to use the ORM client to query the database.
 
+## Multi-tenant Todo
+
+https://github.com/zenstackhq/v3-sample-todo-nextjs
+
+A multi-tenant Todo app built with Next.js, Auth.js, TanStack Query, and ZenStack v3.