Skip to content
Merged
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
29 changes: 29 additions & 0 deletions fern/products/cli-api-reference/cli-changelog/2026-04-22.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,32 @@
## 4.87.0
**`(feat):`** Add new `docs.yml` metadata fields for controlling dynamically generated OG images:
`og:dynamic:text-color`, `og:dynamic:background-color`, `og:dynamic:logo-color`
(`dark` | `light`), and five visibility toggle flags (`og:dynamic:show-logo`,
`og:dynamic:show-section`, `og:dynamic:show-description`, `og:dynamic:show-url`,
`og:dynamic:show-gradient`).
Also fixes a pre-existing gap where `og:dynamic` and `og:background-image` were
missing from the Zod `MetadataConfig` schema, causing `fern check` to reject them.


**`(fix):`** Populate `apiNameToId` in `fern docs dev` so MDX widgets that resolve APIs by
user-facing name (e.g. `<MergeSupportedFieldsByIntegrationWidget apiName="hris_v2" ... />`)
work in local preview. Previously the preview server hardcoded this mapping to
`{}`, causing such widgets to throw `MergeWidgetResolutionError` and render the
affected pages as 500 Internal Server Error.


**`(chore):`** Emit non-fatal warnings during `fern check` / `fern docs dev` when `docs.yml`
metadata settings silently conflict. Covered cases:
- `og:dynamic: true` combined with `og:image` or `twitter:image` (the static
images only apply to the homepage once dynamic generation is enabled).
- `og:dynamic:*` sub-settings or `og:background-image` set without
`og:dynamic: true` (they are ignored).
- `og:dynamic:logo-color` set with `og:dynamic:show-logo: false` (no effect).
- `og:image:width` / `og:image:height` set without `og:image`.
- `og:dynamic:text-color` equal to `og:dynamic:background-color`
(text is invisible).


## 4.86.2
**`(fix):`** Gate the consolidation of top-level OpenAPI servers into a single multi-URL
environment behind a new setting, `multi-server-strategy`, with values
Expand Down
Loading