vite-plus 0.2.8 → 0.2.9

package/dist/toolchain.json

@@ -0,0 +1,193 @@
+{
+  "schemaVersion": 1,
+  "nodes": [
+    {
+      "id": "vite-plus",
+      "name": "vite-plus",
+      "version": "0.2.9",
+      "kind": "package",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "vite-plus-core",
+      "name": "@voidzero-dev/vite-plus-core",
+      "version": "0.2.9",
+      "kind": "package",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": [
+        "vite-plus-core"
+      ]
+    },
+    {
+      "id": "vite",
+      "name": "vite",
+      "version": "8.2.1",
+      "kind": "tool",
+      "delivery": [
+        "bundled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "rolldown",
+      "name": "rolldown",
+      "version": "1.2.3",
+      "kind": "tool",
+      "delivery": [
+        "bundled",
+        "compiled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "vitest",
+      "name": "vitest",
+      "version": "4.1.10",
+      "kind": "tool",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxlint",
+      "name": "oxlint",
+      "version": "1.77.0",
+      "kind": "tool",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxfmt",
+      "name": "oxfmt",
+      "version": "0.62.0",
+      "kind": "tool",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxlint-tsgolint",
+      "name": "oxlint-tsgolint",
+      "version": "7.0.2001",
+      "kind": "tool",
+      "delivery": [
+        "dependency"
+      ],
+      "aliases": [
+        "tsgolint"
+      ]
+    },
+    {
+      "id": "tsdown",
+      "name": "tsdown",
+      "version": "0.22.14",
+      "kind": "tool",
+      "delivery": [
+        "bundled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "vite-task",
+      "name": "vite-task",
+      "revision": "d05b1dcdbaabaa69643ee0b89cebe3cd390957e9",
+      "builtAt": "2026-08-12T02:51:52Z",
+      "kind": "tool",
+      "delivery": [
+        "compiled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxc",
+      "name": "oxc",
+      "version": "0.143.0",
+      "kind": "engine",
+      "delivery": [
+        "compiled"
+      ],
+      "aliases": []
+    },
+    {
+      "id": "oxc-resolver",
+      "name": "oxc-resolver",
+      "version": "11.24.2",
+      "kind": "engine",
+      "delivery": [
+        "compiled"
+      ],
+      "aliases": []
+    }
+  ],
+  "edges": [
+    {
+      "from": "vite-plus",
+      "to": "vite-plus-core",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus-core",
+      "to": "vite",
+      "relationship": "bundles"
+    },
+    {
+      "from": "vite",
+      "to": "rolldown",
+      "relationship": "uses"
+    },
+    {
+      "from": "vite-plus-core",
+      "to": "rolldown",
+      "relationship": "bundles"
+    },
+    {
+      "from": "rolldown",
+      "to": "oxc",
+      "relationship": "compiles"
+    },
+    {
+      "from": "rolldown",
+      "to": "oxc-resolver",
+      "relationship": "compiles"
+    },
+    {
+      "from": "vite-plus-core",
+      "to": "tsdown",
+      "relationship": "bundles"
+    },
+    {
+      "from": "vite-plus",
+      "to": "vitest",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus",
+      "to": "oxlint",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus",
+      "to": "oxlint-tsgolint",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus",
+      "to": "oxfmt",
+      "relationship": "depends-on"
+    },
+    {
+      "from": "vite-plus",
+      "to": "vite-task",
+      "relationship": "compiles"
+    }
+  ]
+}

package/dist/{tsconfig-CVUKLfL8.js → tsconfig-7v_BHagU.js}

@@ -1,6 +1,6 @@
-import { t as BASEURL_TSCONFIG_FIX_PACKAGE, u as createBaseUrlTsconfigFixArgs } from "./constants-BppDcRc1.js";
-import { A as isCancel, C as log, M as runCommandSilently, t as cancelAndExit, x as confirm } from "./prompts-DYap08te.js";
-import { c as parse, o as applyEdits, s as modify } from "./json-BU88uu6o.js";
+import { d as createBaseUrlTsconfigFixArgs, t as BASEURL_TSCONFIG_FIX_PACKAGE } from "./constants-CG513DRa.js";
+import { A as isCancel, C as log, M as runCommandSilently, t as cancelAndExit, x as confirm } from "./prompts-CHz_98bJ.js";
+import { c as parse, o as applyEdits, s as modify } from "./json-qlK6UH0r.js";
 import path from "node:path";
 import { styleText } from "node:util";
 import fs from "node:fs";

package/dist/tsgolint-path.js

@@ -1,2 +1,2 @@
-import { n as resolveWindowsTsgolintExecutable, t as resolveTsgolintExecutable } from "./tsgolint-path-eMZT-oea.js";
+import { n as resolveWindowsTsgolintExecutable, t as resolveTsgolintExecutable } from "./tsgolint-path-CbDReEOx.js";
 export { resolveTsgolintExecutable, resolveWindowsTsgolintExecutable };

package/dist/version.js

@@ -1,6 +1,6 @@
-import { a as printHeader, c as renderCliDoc, r as log, t as accent } from "./terminal-CrqqK8WT.js";
-import { m as version } from "./constants-BppDcRc1.js";
-import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-hV-77cBb.js";
+import { i as log, l as renderCliDoc, o as printHeader, t as accent } from "./terminal-Bz-ps6rJ.js";
+import { h as version } from "./constants-CG513DRa.js";
+import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-B4T8RGMG.js";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/version.ts
@@ -40,7 +40,7 @@ function isVitePlusDeclaredInAncestors(cwd) {
 }
 /**
 * Resolve all tool versions from the locally installed vite-plus package.
-* Uses the `vite-plus/versions` export generated by `syncVersionsExport()`.
+* Uses the `vite-plus/versions` export generated by `syncToolchainExports()`.
 */
 async function resolveToolVersions(localPackagePath) {
 	try {

package/dist/versions.d.ts

@@ -1,9 +1,9 @@
 export declare const versions: {
   readonly 'vite': string;
   readonly 'rolldown': string;
-  readonly 'tsdown': string;
-  readonly 'oxlint': string;
+  readonly 'vitest': string;
   readonly 'oxfmt': string;
+  readonly 'oxlint': string;
   readonly 'oxlint-tsgolint': string;
-  readonly 'vitest': string;
+  readonly 'tsdown': string;
 };

package/dist/versions.js

@@ -1,9 +1,9 @@
 export const versions = {
-  "vite": "8.2.0",
-  "rolldown": "1.2.2",
-  "tsdown": "0.22.14",
-  "oxlint": "1.76.0",
-  "oxfmt": "0.61.0",
+  "vite": "8.2.1",
+  "rolldown": "1.2.3",
+  "vitest": "4.1.10",
+  "oxfmt": "0.62.0",
+  "oxlint": "1.77.0",
   "oxlint-tsgolint": "7.0.2001",
-  "vitest": "4.1.10"
+  "tsdown": "0.22.14"
 };

package/docs/guide/ci.md

@@ -6,12 +6,43 @@ You can use `voidzero-dev/setup-vp` to use Vite+ in CI environments.
 
 [`voidzero-dev/setup-vp`](https://github.com/voidzero-dev/setup-vp) provides integrations for GitHub Actions and GitLab CI/CD. Both install Vite+ and can install project dependencies. The GitHub Action can also set up Node.js and cache package manager data automatically, while the GitLab CI/CD template uses the Node.js runtime and cache configuration provided by the job.
 
+## setup-vp Versioning
+
+Set `<setup-vp-version>` in each example to an exact version from the [`setup-vp` releases page](https://github.com/voidzero-dev/setup-vp/releases). You can use a commit SHA instead. Do not use the `v1` tag. The `v1` tag no longer receives updates.
+
+### Automatic Version Updates
+
+Dependabot and Renovate can update exact versions in GitHub Actions workflows.
+
+To use [Dependabot version updates](https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates), add a `github-actions` entry to `.github/dependabot.yml`:
+
+```yaml [.github/dependabot.yml]
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+```
+
+Dependabot checks `uses:` entries in `.github/workflows` each week.
+
+[Renovate's GitHub Actions manager](https://docs.renovatebot.com/modules/manager/github-actions/) detects `uses:` entries by default. You do not need a package rule for `setup-vp`.
+
+When you use a commit SHA, add the exact release tag in a comment. Renovate uses the comment to find updates:
+
+```yaml
+- uses: voidzero-dev/setup-vp@<commit-sha> # <setup-vp-version>
+```
+
+These settings apply only to GitHub Actions workflows. For GitLab CI/CD, update both version values together.
+
 ## GitHub Actions
 
 The GitHub Action sets up Vite+, the required Node.js version, and the package manager. This means you usually do not need separate `setup-node`, package-manager setup, or manual dependency caching steps in your workflow.
 
 ```yaml [.github/workflows/ci.yml]
-- uses: voidzero-dev/setup-vp@v1
+- uses: voidzero-dev/setup-vp@<setup-vp-version>
   with:
     node-version: '24'
     cache: true
@@ -29,11 +60,13 @@ With `cache: true`, `setup-vp` handles dependency caching for you automatically.
 
 ## GitLab CI/CD
 
-Use the reusable `setup-vp` remote template in your GitLab CI/CD configuration:
+Use the reusable `setup-vp` remote template in your GitLab CI/CD configuration. Set the remote URL and `setup-ref` to the same release tag or commit SHA:
 
 ```yaml [.gitlab-ci.yml]
 include:
-  - remote: 'https://raw.githubusercontent.com/voidzero-dev/setup-vp/v1/gitlab/setup-vp.yml'
+  - remote: 'https://raw.githubusercontent.com/voidzero-dev/setup-vp/<setup-vp-version>/gitlab/setup-vp.yml'
+    inputs:
+      setup-ref: '<setup-vp-version>'
 
 test:
   extends: .setup-vp
@@ -76,7 +109,7 @@ If you are migrating an existing GitHub Actions workflow, you can often replace
 #### After:
 
 ```yaml [.github/workflows/ci.yml]
-- uses: voidzero-dev/setup-vp@v1
+- uses: voidzero-dev/setup-vp@<setup-vp-version>
   with:
     node-version: '24'
     cache: true

package/docs/guide/commit-hooks.md

@@ -1,7 +1,7 @@
 # Commit Hooks
 
-Use `vp config` to install the Git hook dispatcher, and `vp staged` to run checks on staged
-files.
+Use `vp hooks` to manage the Git hook dispatcher, `vp config` for project setup
+(hooks + agent integration), and `vp staged` to run checks on staged files.
 
 ## Overview
 
@@ -9,18 +9,65 @@ Vite+ supports commit hooks and staged-file checks without additional tooling.
 
 Use:
 
-- `vp config` to install generated hook infrastructure and related integrations
+- `vp hooks enable` / `disable` / `status` to manage the generated hook dispatcher
+- `vp config` to install the dispatcher (when not disabled) and update agent integration
 - `vp staged` to run checks against the files currently staged in Git
 
 If you use [`vp create`](/guide/create) or [`vp migrate`](/guide/migrate), Vite+ prompts you to set this up for your project automatically.
 
+### Quick start
+
+```bash
+# Install or refresh the dispatcher
+vp hooks enable
+
+# Check what is active in this clone
+vp hooks status
+
+# Turn hooks off in this clone (survives npm install / prepare)
+vp hooks disable
+
+# Turn them back on
+vp hooks enable
+```
+
 ## Commands
 
+### `vp hooks`
+
+Manage the Vite+ Git hook dispatcher for the current repository:
+
+```bash
+vp hooks enable
+vp hooks enable --hooks-dir .custom-hooks
+vp hooks disable
+vp hooks status
+```
+
+| Command   | Behavior                                                                                                                                                                                                           |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `enable`  | Install or refresh the generated dispatcher under `<hooks-dir>/_` and set `core.hooksPath`. Clears a previous disable preference.                                                                                  |
+| `disable` | Tear down the dispatcher (unset `core.hooksPath` when it points at Vite+, remove `<hooks-dir>/_`) and **persist** the disable decision in local git config so `vp config` / lifecycle scripts do not reinstall it. |
+| `status`  | Show preference, `core.hooksPath`, dispatcher presence, and project-owned hook scripts.                                                                                                                            |
+
+By default, project hooks live in `.vite-hooks`. Pass `--hooks-dir` to use another subdirectory. After the first successful enable, the directory is remembered in local git config for later `enable` / `disable` / `status` / `vp config` calls in this clone.
+
+`status` reports preference as:
+
+- `not set` — no disable preference and no prior enable in this clone
+- `enabled` — enable has run (or the dispatcher is currently owned)
+- `disabled (local)` — after `vp hooks disable`
+
+Check the `Dispatcher` and `core.hooksPath` lines to see whether hooks are actually active.
+
+`disable` / `enable` do **not** delete project-owned hook scripts (for example `.vite-hooks/pre-commit`), the `staged` block in `vite.config.ts`, or lifecycle scripts that call `vp config`.
+
 ### `vp config`
 
 `vp config` configures Vite+ for the current project. It installs the generated Git hook
-dispatcher and can also handle related project integration such as agent setup. By default,
-project hooks are read from `.vite-hooks`:
+dispatcher (unless hooks were disabled with `vp hooks disable`) and can also handle related
+project integration such as agent setup. The hooks directory defaults to `.vite-hooks`, or the
+last directory used by `vp hooks` / `vp config` in this clone:
 
 ```bash
 vp config
@@ -31,14 +78,17 @@ vp config --no-agent
 
 Use `--no-hooks` when you want `vp config` to leave the Git hook dispatcher unchanged. Use
 `--no-agent` when you want it to skip updates to existing coding agent instruction files. You can
-pass both flags when you want `vp config` to skip both setup steps.
+pass both flags when you want `vp config` to skip both setup steps. After `vp hooks disable`,
+`vp config` skips reinstalling the dispatcher and points you at `vp hooks enable` instead of
+prompting again.
 
 You can also set `VP_GIT_HOOKS=0` to disable hook installation from lifecycle scripts such as
 `prepare` or `postinstall`.
 
 Project-owned hook scripts such as `.vite-hooks/pre-commit` should be committed to the repository.
-The generated dispatcher and shims under `.vite-hooks/_` are ignored and recreated by `vp config`.
-`vp config` does not create or modify project hook scripts or staged-file configuration.
+The generated dispatcher and shims under `.vite-hooks/_` are ignored and recreated by `vp config`
+or `vp hooks enable`. Neither command creates or modifies project hook scripts or staged-file
+configuration.
 
 ### `vp staged`
 
@@ -88,7 +138,7 @@ Set `VP_GIT_HOOKS=0` in the environment of the process that runs `git commit`, a
 VP_GIT_HOOKS=0 git commit -m "content update"
 ```
 
-`HUSKY=0` is honored the same way for ecosystem tooling compatibility. Setting `VP_GIT_HOOKS=0` in an environment also keeps `vp config` from reinstalling hooks there when a lifecycle script such as `prepare` runs.
+`HUSKY=0` is honored the same way for ecosystem tooling compatibility. Setting `VP_GIT_HOOKS=0` in an environment also keeps `vp config` / `vp hooks enable` from reinstalling hooks there when a lifecycle script such as `prepare` runs.
 
 ### Init script
 
@@ -107,21 +157,44 @@ Because the hook itself reads this file, it works even when the committing proce
 
 ## Removing commit hooks
 
-To stop using the Vite+ hook dispatcher:
+To stop using the Vite+ hook dispatcher in this clone (and keep `prepare` / `vp config` from
+reinstalling it):
 
-1. Remove `vp config` from the `prepare` or `postinstall` script in `package.json`.
+```bash
+vp hooks disable
+# or, if you used a custom directory:
+vp hooks disable --hooks-dir .custom-hooks
+```
 
-2. Unset the Git hooks path that points at the Vite+ dispatcher:
+This:
+
+1. Unsets `core.hooksPath` when it points at the Vite+ dispatcher
+2. Removes the generated `<hooks-dir>/_` directory
+3. Records a **local** disable preference so lifecycle scripts skip reinstall until you run
+   `vp hooks enable` again
+
+To re-enable:
 
 ```bash
-git config --unset core.hooksPath
+vp hooks enable
 ```
 
-3. Remove the generated dispatcher directory (use your `--hooks-dir` value if you changed it):
+If you no longer want hooks for the project at all (shared with teammates), also remove `vp config`
+from the `prepare` or `postinstall` script in `package.json`.
+
+### Manual equivalent
+
+If you prefer to do it by hand:
 
 ```bash
+git config --unset core.hooksPath
 rm -rf .vite-hooks/_
+# optional: prevent prepare/vp config from reinstalling in this clone
+git config --local vp.hooks.disabled true
+# optional: remembered hooks directory (set by enable/disable)
+# git config --local vp.hooks.dir .vite-hooks
 ```
 
 Project-owned scripts such as `.vite-hooks/pre-commit` and the `staged` block in `vite.config.ts`
 can remain for later use, or you can remove them separately if the project no longer needs them.
+`vp hooks disable` does **not** delete those project-owned files.

package/docs/guide/create.md

@@ -49,23 +49,26 @@ Run `vp create --list` to see the built-in templates and the common shorthand te
 - `--no-editor` skips editor config setup
 - `--git` initialize a git repository
 - `--no-git` skips git repository initialization
-- `--hooks` enables pre-commit hook setup
-- `--no-hooks` skips hook setup
 - `--package-manager <name>` uses a specified package manager (`pnpm`, `npm`, `yarn`, or `bun`)
 - `--approve-builds` approves and runs gated dependency build scripts without prompting
 - `--no-interactive` runs without prompts
 - `--verbose` shows detailed scaffolding output
 - `--list` prints the available built-in and popular templates
+- `--hooks` enables pre-commit hook setup (dispatcher + `.vite-hooks` + `staged` config)
+- `--no-hooks` skips hook setup
+
+After create, manage the dispatcher with `vp hooks status`, `vp hooks disable`, and `vp hooks enable`.
+See the [Commit hooks guide](/guide/commit-hooks).
 
 ### Dependency build scripts
 
-For security, pnpm, bun, and yarn (Berry) do not run a dependency's build scripts (`install` / `postinstall`, e.g. native builds like `better-sqlite3`) until you approve them. When a template adds such a dependency directly, `vp create` surfaces it after installing instead of leaving the project in a half-built state:
+For security, pnpm, bun, yarn (Berry), and npm (v12+) do not run a dependency's build scripts (`install` / `postinstall`, e.g. native builds like `better-sqlite3`) until you approve them. When a template adds such a dependency directly, `vp create` surfaces it after installing instead of leaving the project in a half-built state:
 
 - Interactive: you are asked which of those dependencies to approve and build (nothing is selected by default).
 - Non-interactive: a note lists them and points at `vp pm approve-builds`.
 - `--approve-builds`: approves and builds them automatically, so non-interactive runs (CI) can produce a ready-to-use project.
 
-Approval is recorded the way each package manager expects: pnpm's `allowBuilds`, bun's `trustedDependencies`, or yarn's `dependenciesMeta.<pkg>.built` (in the workspace root manifest). Transitive build scripts you did not choose (e.g. `esbuild` pulled in by Vite) are left at the package manager's defaults and are not surfaced. npm runs build scripts by default, so there is nothing to approve there.
+Approval is recorded the way each package manager expects: pnpm's `allowBuilds`, bun's `trustedDependencies`, npm's `allowScripts`, or yarn's `dependenciesMeta.<pkg>.built` (in the workspace root manifest). Transitive build scripts you did not choose (e.g. `esbuild` pulled in by Vite) are left at the package manager's defaults and are not surfaced. npm 11 and older run build scripts during install, so there is nothing to approve there.
 
 ## Template Options
 

package/docs/guide/fmt.md

@@ -20,11 +20,11 @@ vp fmt . --write
 
 Put formatting configuration directly in the `fmt` block in `vite.config.ts` so all your configuration stays in one place. We do not recommend using `.oxfmtrc.json` with Vite+.
 
-For editors, point the formatter config path at `./vite.config.ts` so format-on-save uses the same `fmt` block:
+For editors, disable nested formatter configs so format-on-save uses the root Vite+ `fmt` block:
 
 ```json [.vscode/settings.json]
 {
-  "oxc.fmt.configPath": "./vite.config.ts"
+  "oxc.fmt.disableNestedConfig": true
 }
 ```
 

package/docs/guide/github-actions-cache.md

@@ -63,6 +63,10 @@ vp run lint # should print "cache hit"
 
 Restore `node_modules/.vite/task-cache` after `vp install`, because package installation can recreate or modify `node_modules`.
 
+Set `<setup-vp-version>` below to an exact version from the [`setup-vp` releases page](https://github.com/voidzero-dev/setup-vp/releases). You can use a commit SHA instead.
+
+See [Automatic Version Updates](/guide/ci#automatic-version-updates) to configure Dependabot or Renovate.
+
 ```yaml [.github/workflows/ci.yml]
 name: CI
 
@@ -80,7 +84,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: voidzero-dev/setup-vp@v1
+      - uses: voidzero-dev/setup-vp@<setup-vp-version>
         with:
           node-version: '24'
           cache: true

package/docs/guide/ide-integration.md

@@ -26,7 +26,8 @@ You can also manually set up the VS Code config:
   "[javascriptreact]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
   "[typescript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
   "[typescriptreact]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
-  "oxc.fmt.configPath": "./vite.config.ts",
+  "oxc.disableNestedConfig": true,
+  "oxc.fmt.disableNestedConfig": true,
   "editor.formatOnSave": true,
   "editor.formatOnSaveMode": "file",
   "editor.codeActionsOnSave": {
@@ -35,7 +36,7 @@ You can also manually set up the VS Code config:
 }
 ```
 
-This gives the project a shared default formatter and enables Oxc-powered fix actions on save. The language-specific override blocks (`[javascript]`, `[typescript]`, etc.) are required because VS Code prioritizes user-level `[language]` settings over the workspace-level `editor.defaultFormatter` — without them, a global Prettier configuration would silently take over. Setting `oxc.fmt.configPath` to `./vite.config.ts` keeps editor format-on-save aligned with the `fmt` block in your Vite+ config. Vite+ uses `formatOnSaveMode: "file"` because Oxfmt does not support partial formatting.
+This gives the project a shared default formatter and enables Oxc-powered fix actions on save. The language-specific override blocks (`[javascript]`, `[typescript]`, etc.) are required because VS Code prioritizes user-level `[language]` settings over the workspace-level `editor.defaultFormatter` — without them, a global Prettier configuration would silently take over. Setting `oxc.disableNestedConfig` and `oxc.fmt.disableNestedConfig` prevents nested Oxlint and Oxfmt configs from diverging from the root Vite+ config. Vite+ uses `formatOnSaveMode: "file"` because Oxfmt does not support partial formatting.
 
 To let the VS Code NPM Scripts panel run scripts through `vp`, add the following to your `.vscode/settings.json`:
 
@@ -99,3 +100,61 @@ You can also manually set up the Zed config:
 ```
 
 Setting `oxfmt.fmt.configPath` to `./vite.config.ts` keeps editor format-on-save aligned with the `fmt` block in your Vite+ config. The full generated config covers additional languages (CSS, HTML, JSON, Markdown, etc.) — run `vp create` or `vp migrate` to get the complete file written automatically.
+
+## JetBrains (IntelliJ, WebStorm, etc...)
+
+For the best Vite+ experience with JetBrains IDEs such as IntelliJ & WebStorm, install the [Oxc](https://plugins.jetbrains.com/plugin/27061-oxc) plugin from the JetBrains marketplace.
+
+When you create or migrate a project, Vite+ prompts you to choose whether you want the editor config written for JetBrains IDEs.
+
+::: tip Vite+ does not merge with existing config files
+Due to some complexities with merging XML files, Vite+ currently does not merge your current files if the files already exist.
+You'll be given the opportunity to replace any existing files, instead of merging.
+:::
+
+You can also manually set up the IDE configuration to match your Vite+ setup:
+
+```xml [.idea/externalDependencies.xml]
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ExternalDependencies">
+    <plugin id="com.github.oxc.project.oxcintellijplugin" />
+  </component>
+</project>
+```
+
+```xml [.idea/workspace.xml]
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <!-- other settings... -->
+  <component name="PropertiesComponent">
+    <![CDATA[{
+      "keyToString": {
+        // other settings
+        "javascript.nodejs.core.library.configured.version": "24.18.0", // Replace with your selected Node.js version
+        "javascript.nodejs.core.library.typings.version": "24.13.3", // Replace with the version of @types/node that corresponds to your runtime (or omit if you don't want it)
+        "javascript.preferred.runtime.type.id": "node",
+        "nodejs_interpreter_path": "$USER_HOME$/.vite-plus/bin/node",
+        "nodejs_package_manager_path": "pnpm" // Replace with your package manager of choice
+      }
+    }]]>
+  </component>
+</project>
+```
+
+```xml [.idea/OxfmtSettings.xml]
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="OxfmtSettings">
+    <option name="preferOxfmtCodeStyleSettings" value="true" />
+  </component>
+</project>
+```
+
+Often, `.idea` folders are gitignored in a project, even the `externalDependencies.xml` file, which is used to tell your IDE what plugins should be used for the workspace.
+
+Please make sure to add this line to your main `.gitignore` file, to ensure that the file will be included:
+
+```gitignore [.gitignore]
+!.idea/externalDependencies.xml
+```

package/docs/guide/index.md

@@ -4,7 +4,7 @@ Vite+ is the unified toolchain and entry point for web development. It manages y
 
 Vite+ ships in two parts: `vp`, the global command-line tool, and `vite-plus`, the local package installed in each project. If you already have a Vite project, use [`vp migrate`](/guide/migrate) to migrate it to Vite+, or paste our [migration prompt](/guide/migrate#migration-prompt) into your coding agent.
 
-Building with an AI assistant? Copy a ready-made setup prompt:
+Building with an AI assistant? View and copy a ready-made setup prompt:
 
 <CopyPrompt />
 
@@ -93,6 +93,7 @@ Vite+ can handle the entire local frontend development cycle from starting a pro
 - [`vp create`](/guide/create) creates new apps, packages, and monorepos.
 - [`vp migrate`](/guide/migrate) moves existing projects onto Vite+.
 - [`vp config`](/guide/commit-hooks) installs the Git hook dispatcher and configures agent integration.
+- [`vp hooks`](/guide/commit-hooks) manages the Git hook dispatcher (`enable`, `disable`, `status`).
 - [`vp staged`](/guide/commit-hooks) runs checks on staged files.
 - [`vp install`](/guide/install) installs dependencies with the right package manager.
 - [`vp env`](/guide/env) manages Node.js versions.
@@ -126,6 +127,7 @@ Vite+ can handle the entire local frontend development cycle from starting a pro
 
 ### Maintain
 
+- [`vp toolchain`](/guide/upgrade#show-the-toolchain) shows the versions and relationships in the active Vite+ toolchain.
 - [`vp upgrade`](/guide/upgrade) updates the `vp` installation itself.
 - [`vp implode`](/guide/implode) removes `vp` and related Vite+ data from your machine.