Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions fern/products/cli-api-reference/pages/commands.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/csharp/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/go/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/java/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand Down
10 changes: 5 additions & 5 deletions fern/products/sdks/overview/php/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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/
```
Expand Down
4 changes: 2 additions & 2 deletions fern/products/sdks/overview/postman/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/python/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/ruby/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand Down
4 changes: 2 additions & 2 deletions fern/products/sdks/overview/swift/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions fern/products/sdks/overview/typescript/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down