From 9864a2ae1d0182750f1040e52ca726e605b4bd24 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Sun, 9 Nov 2025 22:01:53 +0000 Subject: [PATCH 1/6] docs: add theme configuration section to docs.yml page Add documentation for the theme configuration options in docs.yml, including theme.page-actions, theme.sidebar, theme.body, and theme.tabs. This addresses the missing documentation for theme.page-actions that controls the visual style of page action buttons (default vs toolbar). Co-Authored-By: Kapil Gowru --- .../pages/customization/what-is-docs-yml.mdx | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/fern/products/docs/pages/customization/what-is-docs-yml.mdx b/fern/products/docs/pages/customization/what-is-docs-yml.mdx index 66b6b776c..1573ccaef 100644 --- a/fern/products/docs/pages/customization/what-is-docs-yml.mdx +++ b/fern/products/docs/pages/customization/what-is-docs-yml.mdx @@ -683,6 +683,46 @@ page-actions: When enabled, displays an "Open in VS Code" button that allows users to open the page content in Visual Studio Code for editing and development. +## Theme configuration + +Customize the visual appearance and styling of various documentation elements. The theme configuration allows you to control how different components are displayed throughout your documentation site. + +```yaml docs.yml +theme: + page-actions: toolbar + sidebar: minimal + body: canvas + tabs: bubble +``` + + + Controls the visual style of page action buttons. Options: + + - `default`: Standard page actions appearance with buttons displayed in the default style + - `toolbar`: Toolbar-style appearance that displays page actions in a more compact, toolbar-like format + + + + Controls the visual style of the sidebar navigation. Options: + + - `default`: Standard sidebar appearance + - `minimal`: Minimalist sidebar style with reduced visual elements + + + + Controls the visual style of the main content body. Options: + + - `default`: Standard body appearance + - `canvas`: Canvas-style appearance with a distinct visual treatment + + + + Controls the visual style of tab navigation elements. Options: + + - `default`: Standard tab appearance + - `bubble`: Bubble-style tabs with rounded, pill-shaped buttons + + ## GitHub configuration From 930bd34c5e654bb393f6991662bd15f2543cbd84 Mon Sep 17 00:00:00 2001 From: Catherine Deskur <46695336+chdeskur@users.noreply.github.com> Date: Mon, 10 Nov 2025 10:42:23 -0500 Subject: [PATCH 2/6] Update docs.yml --- fern/docs.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/fern/docs.yml b/fern/docs.yml index 144068b32..d845f0f5a 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -142,6 +142,9 @@ layout: searchbar-placement: header tabs-placement: header +theme: + page-actions: toolbar + settings: http-snippets: - curl From 6242afdf7891a97a809f258e9caee609ff15e350 Mon Sep 17 00:00:00 2001 From: Catherine Deskur <46695336+chdeskur@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:09:21 -0500 Subject: [PATCH 3/6] Update fern.config.json --- fern/fern.config.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fern/fern.config.json b/fern/fern.config.json index 11a959709..63ac45a4e 100644 --- a/fern/fern.config.json +++ b/fern/fern.config.json @@ -1,4 +1,4 @@ { "organization": "fern", - "version": "0.107.3" -} \ No newline at end of file + "version": "0.113.0" +} From d41d1acc4e532595f34d81ff0d8954c7af716c0d Mon Sep 17 00:00:00 2001 From: Catherine Deskur <46695336+chdeskur@users.noreply.github.com> Date: Mon, 10 Nov 2025 11:49:52 -0500 Subject: [PATCH 4/6] Update fern.config.json --- fern/fern.config.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/fern.config.json b/fern/fern.config.json index 63ac45a4e..0e6b7b694 100644 --- a/fern/fern.config.json +++ b/fern/fern.config.json @@ -1,4 +1,4 @@ { "organization": "fern", - "version": "0.113.0" + "version": "0.113.1" } From 81e939175b7d5499f6859d38b10d5d0759831794 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Mon, 10 Nov 2025 12:06:17 -0500 Subject: [PATCH 5/6] make intro more concise --- fern/products/docs/pages/customization/site-level-settings.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/products/docs/pages/customization/site-level-settings.mdx b/fern/products/docs/pages/customization/site-level-settings.mdx index bbeac31d4..2f75503a8 100644 --- a/fern/products/docs/pages/customization/site-level-settings.mdx +++ b/fern/products/docs/pages/customization/site-level-settings.mdx @@ -685,7 +685,7 @@ page-actions: ## Theme configuration -Customize the visual appearance and styling of various documentation elements. The theme configuration allows you to control how different components are displayed throughout your documentation site. +Configure the visual styling of various documentation elements throughout your site. ```yaml docs.yml theme: From 2068d5562b38e04e43c0dbd28ac9e7c03015b169 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 12 Nov 2025 06:53:12 +0000 Subject: [PATCH 6/6] docs: update theme configuration to only include page-actions and footer-nav - Add footer-nav theme option (default vs minimal) - Remove sidebar, body, and tabs theme options (not properly implemented yet) - Update Fern CLI version to 0.113.1 - Update documentation in site-level-settings.mdx (renamed from what-is-docs-yml.mdx) Co-Authored-By: Kapil Gowru --- .../customization/site-level-settings.mdx | 26 ++++--------------- 1 file changed, 5 insertions(+), 21 deletions(-) diff --git a/fern/products/docs/pages/customization/site-level-settings.mdx b/fern/products/docs/pages/customization/site-level-settings.mdx index 2f75503a8..e9d7386c5 100644 --- a/fern/products/docs/pages/customization/site-level-settings.mdx +++ b/fern/products/docs/pages/customization/site-level-settings.mdx @@ -690,9 +690,7 @@ Configure the visual styling of various documentation elements throughout your s ```yaml docs.yml theme: page-actions: toolbar - sidebar: minimal - body: canvas - tabs: bubble + footer-nav: minimal ``` @@ -702,25 +700,11 @@ theme: - `toolbar`: Toolbar-style appearance that displays page actions in a more compact, toolbar-like format - - Controls the visual style of the sidebar navigation. Options: + + Controls the visual style of the footer navigation (previous/next page links). Options: - - `default`: Standard sidebar appearance - - `minimal`: Minimalist sidebar style with reduced visual elements - - - - Controls the visual style of the main content body. Options: - - - `default`: Standard body appearance - - `canvas`: Canvas-style appearance with a distinct visual treatment - - - - Controls the visual style of tab navigation elements. Options: - - - `default`: Standard tab appearance - - `bubble`: Bubble-style tabs with rounded, pill-shaped buttons + - `default`: Standard footer navigation appearance + - `minimal`: Minimalist footer navigation style with reduced visual elements ## GitHub configuration