diff --git a/docs/2.guide/1.concepts/8.typescript.md b/docs/2.guide/1.concepts/8.typescript.md
index e2718dc55f..afc7ae5a05 100644
--- a/docs/2.guide/1.concepts/8.typescript.md
+++ b/docs/2.guide/1.concepts/8.typescript.md
@@ -9,22 +9,26 @@ By default, Nuxt doesn't check types when you run [`nuxi dev`](/docs/api/command
 
 To enable type-checking at build or development time, install `vue-tsc` and `typescript` as development dependency:
 
+::alert{type="warning"}
+You may experience issues with the latest `vue-tsc` and `vite-plugin-checker`, used internally when type checking. For now, you may need to stay on v1 of `vue-tsc`, and follow these upstream issues for updates: [fi3ework/vite-plugin-checker#306](https://github.com/fi3ework/vite-plugin-checker/issues/306) and [vuejs/language-tools#3969](https://github.com/vuejs/language-tools/issues/3969).
+::
+
 ::code-group
 
   ```bash [yarn]
-  yarn add --dev vue-tsc typescript
+  yarn add --dev vue-tsc@^1 typescript
   ```
 
   ```bash [npm]
-  npm install --save-dev vue-tsc typescript
+  npm install --save-dev vue-tsc@^1 typescript
   ```
 
   ```bash [pnpm]
-  pnpm add -D vue-tsc typescript
+  pnpm add -D vue-tsc@^1 typescript
   ```
 
   ```bash [bun]
-  bun add -D vue-tsc typescript
+  bun add -D vue-tsc@^1 typescript
   ```
 
 ::