Skip to content

Commit 7133b52

Browse files
docs: bring the development runbook up to date
Node 26 comes from vp, the main checkout's dev state lives in ~/.t3/dev, first worktree starts seed their database, and marketing no longer runs astro check. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent de2f78b commit 7133b52

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

‎docs/operations/development.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
## First checkout
44

5-
Install `vp` using the [root README](../../README.md#install-vp). The checkout requires Node 24.
6-
From the repository root:
5+
Install `vp` using the [root README](../../README.md#install-vp). It provides the Node version
6+
pinned in `package.json` (Node 26), so no separate Node install is needed. From the repository root:
77

88
```sh
99
vp i
@@ -68,7 +68,9 @@ Add `--browser` to open a browser automatically.
6868
### State and ports
6969

7070
Linked worktrees default to their own `.t3/userdata`, even when `T3CODE_HOME` is set.
71-
The main checkout defaults to `~/.t3/dev/userdata`. An explicit `--home-dir` wins in both cases.
71+
The main checkout defaults to `~/.t3/dev`. An explicit `--home-dir` wins in both cases.
72+
The first start in a worktree seeds its empty database from a read-only copy of
73+
`~/.t3/userdata`; `--no-seed` or `T3CODE_DEV_SEED=0` skips that.
7274
Never run a development server against the live `~/.t3/userdata`.
7375
See [test data](../../AGENTS.md#test-data) for copying a consistent database snapshot.
7476

@@ -173,7 +175,6 @@ and runs in headless Chromium with the React Compiler on, like the app. There is
173175
TypeScript workspaces typecheck with `tsc`. The `typescript` catalog entry is
174176
`@tsc-rs/typescript`, the tsc-rs drop-in, with Effect diagnostics, quick fixes, and
175177
refactors built in. VS Code uses it through `js/ts.tsdk.path` in `.vscode/settings.json`.
176-
Marketing keeps `astro check` for Astro files.
177178

178179
Use `vp run lint:mobile` for native mobile changes. CI owns the full suite; see
179180
[ci.yml](../../.github/workflows/ci.yml) for its current jobs.

0 commit comments

Comments
 (0)