diff --git a/fern/products/cli-api-reference/pages/commands.mdx b/fern/products/cli-api-reference/pages/commands.mdx
index 1235cd15..b3e6c591 100644
--- a/fern/products/cli-api-reference/pages/commands.mdx
+++ b/fern/products/cli-api-reference/pages/commands.mdx
@@ -174,21 +174,29 @@ hideOnThisPage: true
 
     <CodeBlock title="terminal">
     ```bash
-    fern generate [--group <group>] [--api <api>] [--version <version>] [--preview]
+    fern generate [--deep] [--group <group>] [--api <api>] [--version <version>] [--preview]
     ```
     </CodeBlock>
 
+    ### deep
+
+    Use `--deep` to enable deep generation mode. This flag is recommended for the latest CLI version and ensures complete SDK generation.
+
+    ```bash
+    fern generate --deep --group ts-sdk
+    ```
+
     ### preview
 
     Use `--preview` to test SDK changes locally before publishing. This is especially useful during development:
     - Generates SDK into a local `.preview/` folder
     - Allows quick iteration on your Fern definition
     - No changes are published to package managers or GitHub
-    
+
     ```bash
     # Preview all SDKs
     fern generate --preview
-    
+
     # Preview specific SDK group
     fern generate --group python-sdk --preview
     ```
diff --git a/fern/products/sdks/overview/csharp/quickstart.mdx b/fern/products/sdks/overview/csharp/quickstart.mdx
index 201e64d4..34a16aff 100644
--- a/fern/products/sdks/overview/csharp/quickstart.mdx
+++ b/fern/products/sdks/overview/csharp/quickstart.mdx
@@ -42,22 +42,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group csharp-sdk
+fern generate --deep --group csharp-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group csharp-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group csharp-sdk --api your-api-name
+  ```
 </Note>
 
 <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group csharp-sdk
+sdks/ # created by fern generate --deep --group csharp-sdk
 ├─ csharp
     └─ src/
         ├─ YourOrganizationApi.sln
diff --git a/fern/products/sdks/overview/go/quickstart.mdx b/fern/products/sdks/overview/go/quickstart.mdx
index dea50f96..0006d6e1 100644
--- a/fern/products/sdks/overview/go/quickstart.mdx
+++ b/fern/products/sdks/overview/go/quickstart.mdx
@@ -42,22 +42,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group go-sdk
+fern generate --deep --group go-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group go-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group go-sdk --api your-api-name
+  ```
 </Note>
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group go-sdk
+sdks/ # created by fern generate --deep --group go-sdk
 ├─ go
     ├─ core/
     └─ go.mod
diff --git a/fern/products/sdks/overview/java/quickstart.mdx b/fern/products/sdks/overview/java/quickstart.mdx
index ca4076a5..dec2c49d 100644
--- a/fern/products/sdks/overview/java/quickstart.mdx
+++ b/fern/products/sdks/overview/java/quickstart.mdx
@@ -42,22 +42,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group java-sdk
+fern generate --deep --group java-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group java-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group java-sdk --api your-api-name
+  ```
 </Note>
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group java-sdk
+sdks/ # created by fern generate --deep --group java-sdk
 ├─ java
     ├─ YourOrganizationApiClient.java
     ├─ core/
diff --git a/fern/products/sdks/overview/php/quickstart.mdx b/fern/products/sdks/overview/php/quickstart.mdx
index 60ab8ab1..6afc70f8 100644
--- a/fern/products/sdks/overview/php/quickstart.mdx
+++ b/fern/products/sdks/overview/php/quickstart.mdx
@@ -43,27 +43,27 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group php-sdk
+fern generate --deep --group php-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group php-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group php-sdk --api your-api-name
+  ```
 </Note>
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group php-sdk
+sdks/ # created by fern generate --deep --group php-sdk
 ├─ php
     └─ sdk/
         ├─ src/
             ├─ YourOrganizationClient.php
-            └─ Types/ 
+            └─ Types/
         └─ tests/
             └─ Core/
 ```
diff --git a/fern/products/sdks/overview/postman/quickstart.mdx b/fern/products/sdks/overview/postman/quickstart.mdx
index ba9bee6e..6dab8efa 100644
--- a/fern/products/sdks/overview/postman/quickstart.mdx
+++ b/fern/products/sdks/overview/postman/quickstart.mdx
@@ -46,14 +46,14 @@ groups:
 Run the following command:
 
 ```sh
-fern generate --group postman
+fern generate --deep --group postman
 ```
 
 <Note>
     If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
     ```bash
-    fern generate --group postman --api your-api-name
+    fern generate --deep --group postman --api your-api-name
     ```
 </Note>
 
diff --git a/fern/products/sdks/overview/python/quickstart.mdx b/fern/products/sdks/overview/python/quickstart.mdx
index 6e8a6dac..2cf048e4 100644
--- a/fern/products/sdks/overview/python/quickstart.mdx
+++ b/fern/products/sdks/overview/python/quickstart.mdx
@@ -42,22 +42,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group python-sdk
+fern generate --deep --group python-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group python-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group python-sdk --api your-api-name
+  ```
 </Note>
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group python-sdk
+sdks/ # created by fern generate --deep --group python-sdk
 ├─ python
     ├─ __init__.py
     ├─ client.py
diff --git a/fern/products/sdks/overview/ruby/quickstart.mdx b/fern/products/sdks/overview/ruby/quickstart.mdx
index 9058e3c0..a6851191 100644
--- a/fern/products/sdks/overview/ruby/quickstart.mdx
+++ b/fern/products/sdks/overview/ruby/quickstart.mdx
@@ -43,22 +43,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group ruby-sdk
+fern generate --deep --group ruby-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group ruby-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group ruby-sdk --api your-api-name
+  ```
 </Note>
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group ruby-sdk
+sdks/ # created by fern generate --deep --group ruby-sdk
 ├─ ruby
     ├─ YourOrganization_api_client.gemspec
     ├─ test/
diff --git a/fern/products/sdks/overview/swift/quickstart.mdx b/fern/products/sdks/overview/swift/quickstart.mdx
index dbc17d57..caf2cd1a 100644
--- a/fern/products/sdks/overview/swift/quickstart.mdx
+++ b/fern/products/sdks/overview/swift/quickstart.mdx
@@ -42,14 +42,14 @@ This command adds the following `group` to `generators.yml`:
   Run the following command to generate your SDK:
 
   ```bash
-  fern generate --group swift-sdk
+  fern generate --deep --group swift-sdk
   ```
 
   <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group swift-sdk
+sdks/ # created by fern generate --deep --group swift-sdk
 ├─ swift
     ├─ Package.swift
     └─ Sources
diff --git a/fern/products/sdks/overview/typescript/quickstart.mdx b/fern/products/sdks/overview/typescript/quickstart.mdx
index b6ab2c5b..a570341f 100644
--- a/fern/products/sdks/overview/typescript/quickstart.mdx
+++ b/fern/products/sdks/overview/typescript/quickstart.mdx
@@ -42,22 +42,22 @@ This command adds the following `group` to `generators.yml`:
 Run the following command to generate your SDK:
 
 ```bash
-fern generate --group ts-sdk
+fern generate --deep --group ts-sdk
 ```
 
 <Note>
   If you have multiple APIs, use the [`--api` flag](/cli-api-reference/cli-reference/commands#api) to specify the API you want to generate:
 
   ```bash
-  fern generate --group ts-sdk --api your-api-name
-  ``` 
+  fern generate --deep --group ts-sdk --api your-api-name
+  ```
 </Note>
 
 <Markdown src="/products/sdks/snippets/generate-sdk.mdx"/>
 
 ```bash
 fern/ # created by fern init
-sdks/ # created by fern generate --group ts-sdk
+sdks/ # created by fern generate --deep --group ts-sdk
 ├─ typescript
     ├─ Client.ts
     ├─ index.ts