2.13.0
(feat): Allow all API settings to be overridden at the generator level in generators.yml.
(feat): Add CLI migration to automatically convert deprecated generator-level API settings keys to their new equivalents: use-title to title-as-schema-name, and unions: v1 to prefer-undiscriminated-unions-with-literals: true.
2.12.0
(feat): Support per-generator auth-schemes override in generators.yml. Generators can now define their own auth-schemes at the generator level, which takes precedence over top-level definitions.
2.10.0
(feat): Support per-generator specs override in generators.yml. Generators can now redefine the api.specs configuration at the individual generator level, allowing different specs configurations for different generators.
2.11.0
(feat): When converting OpenAPI to Fern Definition, if all endpoints in a service have auth: true, set the auth: true at the service level, and remove it from individual endpoints.
2.9.0
(fix): When importing OpenAPI specs, endpoints now properly inherit authentication requirements defined at the global level.
2.8.2
(fix): Fix dynamic snippet property ordering for types with inheritance. Types that are extended by other types now have their own properties ordered before inherited properties in the Dynamic IR. This fixes Java SDK staged builder compilation errors where method call order is enforced at compile time.
2.8.1
(fix): Support a lines prop for the <Code /> component to extract specific lines from a code snippet.
2.8.0
(feat): Adds an option for api.tag-description-pages: true to create summary pages from tag descriptions within an API reference.
2.7.1
(fix): Fix fern docs dev bug on Windows where asset paths were not parsing correctly
2.7.0
(feat): Support per-generator auth overrides in generators.yml.
In the following example the TypeScript SDK generator will use Basic auth while the rest of the APIs use OAuth.
2.6.2
(fix): Support generating examples for x-fern-type: literal<...> values in OpenAPI specs. Parameters with literal type annotations now generate examples using the underlying literal value.
2.6.1
(fix): Fix docs broken-links validator incorrectly flagging external URLs that contain the docs domain in query parameters.
2.5.2
(fix): Remove spammy “Cannot resolve source” warnings for OpenAPI sources in unioned API configurations with dependencies.
2.6.0
(feat): Support 4XX and 5XX patterns in OpenAPI specs for docs.
2.5.1
(fix): Add validation for instance URLs to ensure they are valid.
2.5.0
(feat): Support product and version-specific announcements in docs.yml.
2.2.6
(fix): Update local development refresh behavior when updating the sidebar-title override, or a slug override of a page. The preview should now navigate to the new slug instead of showing a 404.
2.2.5
(chore): Revert “fix(openapi): handle situations where discriminated unions reference unknown variants”
2.2.4
(fix): Re-publish CLI.
2.2.3
(fix): Support <Code /> components with props formatted on multiple lines.
2.4.0
(feat): Add branch support to self-hosted GitHub generation. Users can now specify a target branch in their generators.yml configuration using the branch field. When specified, generated code will be pushed to that branch instead of the default branch.
2.2.1
(fix): Add clarified output for unchanged generator versions (i.e., generators already on the latest version) to fern generator upgrade.
2.2.0
(feat): Support x-code-samples in OpenAPI specs on the latest version of the OpenAPI parser.
2.3.0
(fix): Add messaging about AI example generation to the CLI.
2.1.0
(feat): Add detailed output to fern generator upgrade showing which generators were upgraded, their version changes, and changelog links. The command now displays a summary grouped by workspace and group, or reports “All generators are already up to date” when no upgrades are applied.
2.0.4
(fix): Optimize docs generation and image path parsing and replacement for large markdown files (>5MB) using batched edits, precomputed line positions, and filtered AST traversal.
2.0.3
(fix): Updates CLI dependencies to fix fern commands.
2.0.2
(fix): Updates dependencies to fix fern commands.
2.0.1
(fix): Updates the beta write-translation command to use --stub flag for mocking translation configuration.
2.0.0
(feat): Support sidebar title overrides in the frontmatter of markdown files.
2.0.0-rc2
(fix): Improve misc error handling, including for illegal version strings.
2.0.0-rc1
(fix): Fix migration directory name to match exported version (2.0.0-rc0).
2.0.0-rc0
(break): Change default for OpenAPI parsing setting:
coerce-enums-to-literals:false(wastrue) The CLI will automatically upgrade your generators.yml to explicitly set the old default to preserve existing behavior. New users will get the new default.
1.11.3
(fix): Improve misc error handling, including for illegal version strings
1.11.2
(fix): Fix OpenAPI enum references being inlined instead of preserved as references. Enum schemas (type: string with enum property) are no longer treated as inlinable primitives, ensuring that $ref to enum schemas maintain their reference structure in the generated IR.
1.11.1
(fix): Fix AutoVersioning to exclude Fern branding from commit messages and PR titles/descriptions when whitelabel config is present.
1.11.0
(feat): Use commit message for auto versioning PR title and description. When auto versioning is successful, the first line of the commit message becomes the PR title and the rest becomes the PR body.
1.10.3
(fix): Fix whitelabel behavior for local generation.
1.10.2
(fix): Support JSX titles in <Code /> components.
1.10.1
(fix): Tweak SDK diffing AI prompt to work better with larger diffs.
1.10.0
(feat): Add automatic semantic versioning to local generation with --version AUTO --local flags.
1.9.2
(fix): Fix issue where x-fern-explorer was not hiding routes from the API Explorer
1.9.1
(fix): Fix issue where <Code /> components were not able to be added during fern docs dev mode.
1.9.0
(feat): Add external configuration to tsup build to prevent dev-only dependencies (prettier, vitest, typescript, tsup, depcheck, @types/*) from being accidentally bundled.
This ensures the CLI bundle only includes runtime dependencies and enables metafile generation for bundle analysis.
1.8.1
(fix): Fix issue where local generation for github output mode wasn’t producing README.md files
1.8.0
(feat): Add fern sdk-diff command to analyze the differences between two SDKs and generate a commit message and version bump.
1.7.0
(feat): Replace prettier2 with yaml package in fern format command to reduce CLI bundle size by ~4.3 MB (11.4% reduction from 38 MB to 33.67 MB).
YAML formatting output may have minor differences (e.g., extra blank lines after section headers like types: and errors:).
1.6.0
(feat): Add fern self-update command to update the globally installed Fern CLI.
The command detects how the CLI was installed (npm, pnpm, yarn, bun, or brew) and runs the appropriate update command.
Supports updating to a specific version (e.g., fern self-update 0.85.0) or the latest version (e.g., fern self-update).
Includes --dry-run flag to preview the update command without executing it.
1.5.0
(feat): Add fern downgrade <version> command to set the CLI version in fern.config.json. This allows users to pin their project to a specific CLI version without running migrations.
1.4.0
(feat): Enable local generation with preview mode by removing incompatibility restriction and migrating github
operations handling from generator-cli to fern-cli.
1.3.1
(fix): Fix duplicate upgrade messages when one CLI version reruns another. The parent process now properly suppresses its upgrade nudge so only a single message is shown.
1.3.0
(fix): Made fern upgrade safer by running migrations before updating fern.config.json. If migrations fail, your config stays unchanged.
(feat): Added --from flag to fern upgrade to manually specify the version to migrate from when needed.
(fix): Improved fern upgrade reliability by automatically detecting and recovering from faulty CLI upgrades. When upgrading from a problematic CLI version, Fern now retrieves the correct previous version from git history to ensure migrations run properly.
1.3.0-rc2
(fix): Make sure fern upgrade with --rc follows the same migration logic as non-rc upgrades.
1.3.0-rc1
(fix): Make sure fern upgrade with --rc follows the same migration logic as non-rc upgrades.
1.3.0-rc0
(fix): Made fern upgrade safer by running migrations before updating fern.config.json. If migrations fail, your config stays unchanged.
(feat): Added --from flag to fern upgrade to manually specify the version to migrate from when needed.
(fix): Improved fern upgrade reliability by automatically detecting and recovering from faulty CLI upgrades. When upgrading from a problematic CLI version, Fern now retrieves the correct previous version from git history to ensure migrations run properly.
