From b3498d8d7fb5f8bbb33405c85e97b6269a8e5daf Mon Sep 17 00:00:00 2001
From: Bartosz Gentkowski <bartosz.gentkowski@nordicsemi.no>
Date: Thu, 21 May 2026 15:29:43 +0200
Subject: [PATCH] doc: build doc for 1.0.0 with new theme

DNM

Signed-off-by: Bartosz Gentkowski <bartosz.gentkowski@nordicsemi.no>
---
 doc/_doxygen/doxygen-awesome.css | 145 +++++++++++++++++++++++--------
 doc/_doxygen/logo.png            | Bin 4338 -> 20890 bytes
 doc/_doxygen/search.html         |  14 +++
 doc/nrf-bm/conf.py               |  10 ++-
 doc/requirements.txt             |   2 +-
 doc/versions.json                |   5 ++
 6 files changed, 140 insertions(+), 36 deletions(-)
 create mode 100644 doc/_doxygen/search.html
 create mode 100644 doc/versions.json

diff --git a/doc/_doxygen/doxygen-awesome.css b/doc/_doxygen/doxygen-awesome.css
index 98b835cdbd..4f78d469f2 100644
--- a/doc/_doxygen/doxygen-awesome.css
+++ b/doc/_doxygen/doxygen-awesome.css
@@ -29,17 +29,21 @@ SOFTWARE.
 
 html {
     /* primary theme color. This will affect the entire websites color scheme: links, arrows, labels, ... */
-    --primary-color: #1779c4;
-    --primary-dark-color: #335c80;
-    --primary-light-color: #70b1e9;
+
+    --primary-color: #00a9ce;
+    --primary-dark-color: #0056b3;
+    --primary-light-color: #5cc8e0;
 
     /* page base colors */
     --page-background-color: #ffffff;
-    --page-foreground-color: #2f4153;
-    --page-secondary-foreground-color: #6f7e8e;
+    --page-foreground-color: #323e48;
+    --page-secondary-foreground-color: #6b7280;
 
     /* color for all separators on the website: hr, borders, ... */
-    --separator-color: #dedede;
+    --separator-color: #e2e8f0;
+    --font-family: "Noto Sans", Carlito, sans-serif;
+    --font-family-monospace: ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;
+
 
     /* border radius for all rounded components. Will affect many components, like dropdowns, memitems, codeblocks, ... */
     --border-radius-large: 8px;
@@ -64,14 +68,13 @@ html {
     --font-family-monospace: ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;
 
     /* font sizes */
-    --page-font-size: 15.6px;
+    --page-font-size: 16px;
     --navigation-font-size: 14.4px;
     --toc-font-size: 13.4px;
-    --code-font-size: 14px; /* affects code, fragment */
     --title-font-size: 22px;
 
     /* content text properties. These only affect the page content, not the navigation or any other ui elements */
-    --content-line-height: 27px;
+    --content-line-height: 23px;
     /* The content is centered and constraint in it's width. To make the content fill the whole page, set the variable to auto.*/
     --content-maxwidth: 1050px;
     --table-line-height: 24px;
@@ -84,7 +87,7 @@ html {
     --warning-color-dark: #f3a600;
     --warning-color-darker: #5f4204;
     --note-color: #e4f3ff;
-    --note-color-dark: #1879C4;
+    --note-color-dark: #00a9ce;
     --note-color-darker: #274a5c;
     --todo-color: #e4dafd;
     --todo-color-dark: #5b2bdd;
@@ -104,8 +107,9 @@ html {
     --blockquote-foreground: #636568;
 
     /* table colors */
-    --tablehead-background: #f1f1f1;
-    --tablehead-foreground: var(--page-foreground-color);
+
+    --tablehead-background: #eaeded;
+    --tablehead-foreground: #333f48;
 
     /* menu-display: block | none
      * Visibility of the top navigation on screens >= 768px. On smaller screen the menu is always visible.
@@ -113,8 +117,8 @@ html {
      */
     --menu-display: block;
 
-    --menu-focus-foreground: var(--page-background-color);
-    --menu-focus-background: var(--primary-color);
+    --menu-focus-foreground: #0033a0;
+    --menu-focus-background: #e0f4f9;
     --menu-selected-background: rgba(0,0,0,.05);
 
 
@@ -122,16 +126,37 @@ html {
     --header-foreground: var(--page-foreground-color);
 
     /* searchbar colors */
-    --searchbar-background: var(--side-nav-background);
-    --searchbar-foreground: var(--page-foreground-color);
+    --searchbar-background: #ffffff;
+    --searchbar-foreground: #666f7b;
 
     /* searchbar size
      * (`searchbar-width` is only applied on screens >= 768px.
      * on smaller screens the searchbar will always fill the entire screen width) */
-    --searchbar-height: 33px;
-    --searchbar-width: 210px;
-    --searchbar-border-radius: var(--searchbar-height);
+     --searchbar-height: 36px;
+     --searchbar-width: 100%;
+     max-width: none;
+     --searchbar-border-radius: 4px;
+    /* Nordic-like search (see sphinx nordic .ncs-search-input) */
+#MSearchBox {
+    background: #ffffff !important;
+    border: 1px solid rgba(0, 0, 0, 0.08) !important;
+    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06) !important;
+    border-radius: 4px !important;
+}
+
+#MSearchBox.MSearchBoxActive {
+    border-color: #00a9ce !important;
+    box-shadow: 0 0 0 1px #00a9ce !important;
+}
+
+#MSearchField {
+    color: #666f7b !important;
+}
 
+#MSearchField::placeholder {
+    color: #666f7b !important;
+    opacity: 1;
+}
     /* code block colors */
     --code-background: #f5f5f5;
     --code-foreground: var(--page-foreground-color);
@@ -144,7 +169,7 @@ html {
     --fragment-keywordflow: #d67c3b;
     --fragment-token: #438a59;
     --fragment-comment: #969696;
-    --fragment-link: #5383d6;
+    --fragment-link: #00a9ce;
     --fragment-preprocessor: #46aaa5;
     --fragment-linenumber-color: #797979;
     --fragment-linenumber-background: #f4f4f5;
@@ -152,7 +177,8 @@ html {
     --fragment-lineheight: 20px;
 
     /* sidebar navigation (treeview) colors */
-    --side-nav-background: #fbfbfb;
+
+    --side-nav-background: #ffffff;
     --side-nav-foreground: var(--page-foreground-color);
     --side-nav-arrow-opacity: 0;
     --side-nav-arrow-hover-opacity: 0.9;
@@ -347,7 +373,7 @@ a.anchor {
  */
 
 #top {
-    background: var(--header-background);
+    background:#333f48;;
     border-bottom: 1px solid var(--separator-color);
 }
 
@@ -363,14 +389,16 @@ a.anchor {
 #main-nav {
     flex-grow: 5;
     padding: var(--spacing-small) var(--spacing-medium);
+    margin-bottom: 18px;
 }
 
 #titlearea {
     width: auto;
-    padding: var(--spacing-medium) var(--spacing-large);
+    /* padding: var(--spacing-medium) var(--spacing-large); */
     background: none;
     color: var(--header-foreground);
     border-bottom: none;
+    padding: 0px 15px 23px 16px;
 }
 
 @media screen and (max-width: 767px) {
@@ -386,6 +414,7 @@ a.anchor {
 #projectname {
     font-size: var(--title-font-size);
     font-weight: 600;
+    color: white;
 }
 
 #projectnumber {
@@ -405,6 +434,9 @@ a.anchor {
 #projectlogo img {
     max-height: calc(var(--title-font-size) * 2);
     margin-right: var(--spacing-small);
+    max-height: 93px;
+    width: auto;
+    max-width: 200px;
 }
 
 .sm-dox, .tabs, .tabs2, .tabs3 {
@@ -416,7 +448,24 @@ a.anchor {
     border-bottom: 1px solid var(--separator-color);
     margin-bottom: -1px;
 }
-
+li#searchBoxPos2 {
+    right: 1.5rem;
+}
+doxygen-awesome-dark-mode-toggle svg {
+    color: #ffffff;
+  }
+
+  doxygen-awesome-dark-mode-toggle svg path,
+  doxygen-awesome-dark-mode-toggle svg circle,
+  doxygen-awesome-dark-mode-toggle svg line,
+  doxygen-awesome-dark-mode-toggle svg g {
+    fill: #ffffff !important;
+    stroke: #ffffff !important;
+  }
+  doxygen-awesome-dark-mode-toggle svg {
+    transform: scale(0.75);   /* try 0.65–0.9 */
+    transform-origin: center;
+  }
 .main-menu-btn-icon, .main-menu-btn-icon:before, .main-menu-btn-icon:after {
     background: var(--page-secondary-foreground-color);
 }
@@ -432,9 +481,11 @@ a.anchor {
     }
 
     #main-menu a.has-submenu:hover span.sub-arrow {
-        color: var(--page-foreground-color);
+        border-color: #0033a0 transparent transparent transparent;
+        color: #0033a0;
+    }
     }
-}
+
 
 @media screen and (min-width: 768px) {
     .sm-dox li, .tablist li {
@@ -446,7 +497,8 @@ a.anchor {
     }
 
     .sm-dox a:hover span.sub-arrow {
-        border-color: var(--menu-focus-foreground) transparent transparent transparent;
+        border-color: #0033a0 transparent transparent transparent;
+        color: #0033a0;
     }
 
     .sm-dox ul a span.sub-arrow {
@@ -454,10 +506,32 @@ a.anchor {
     }
 
     .sm-dox ul a:hover span.sub-arrow {
-        border-color: transparent transparent transparent var(--menu-focus-foreground);
+        border-color: #0033a0 transparent transparent transparent;
+        color: #0033a0;
     }
-}
+    }
+    @media screen and (min-width: 768px) {
+        /* top row: down-arrow */
+        .sm-dox a.highlighted span.sub-arrow,
+        .sm-dox a[aria-expanded="true"] span.sub-arrow {
+          border-color: var(--menu-focus-foreground) transparent transparent transparent;
+          /* or: #0033a0 */
+        }
 
+        /* submenus: right-arrow */
+        .sm-dox ul a.highlighted span.sub-arrow,
+        .sm-dox ul a[aria-expanded="true"] span.sub-arrow {
+          border-color: transparent transparent transparent var(--menu-focus-foreground);
+        }
+      }
+
+#MSearchField {
+    background-image: url(search.svg);
+    background-repeat: no-repeat;
+    background-position: 10px center;
+    background-size: 1rem;
+    padding-left: 2.25rem !important;
+}
 .sm-dox ul {
     background: var(--page-background-color);
     box-shadow: var(--box-shadow);
@@ -495,9 +569,10 @@ a.anchor {
 
 .sm-dox ul a:hover, .sm-dox ul a:active, .sm-dox ul a:focus {
     font-size: var(--navigation-font-size) !important;
-    color: var(--menu-focus-foreground) !important;
+    /* color: var(--menu-focus-foreground) !important; */
     text-shadow: none;
-    background-color: var(--menu-focus-background);
+    background-color: #e0f4f9 !important;
+    color: #0033a0 !important;
     border-radius: var(--border-radius-small) !important;
 }
 
@@ -505,7 +580,7 @@ a.anchor {
     text-shadow: none;
     background: transparent;
     background-image: none !important;
-    color: var(--header-foreground) !important;
+    color: #ffffff !important;
     font-weight: normal;
     font-size: var(--navigation-font-size);
     border-radius: var(--border-radius-small) !important;
@@ -518,10 +593,12 @@ a.anchor {
 .sm-dox a:hover, .sm-dox a:active, .tablist li a:hover {
     text-shadow: none;
     font-weight: normal;
-    background: var(--menu-focus-background);
-    color: var(--menu-focus-foreground) !important;
+    /* background: var(--menu-focus-background); */
+    /* color: var(--menu-focus-foreground) !important; */
     border-radius: var(--border-radius-small) !important;
     font-size: var(--navigation-font-size);
+    background-color: rgb(224, 244, 249) !important;
+    color: #0033a0 !important;
 }
 
 .tablist li.current {
diff --git a/doc/_doxygen/logo.png b/doc/_doxygen/logo.png
index 9ebfb7b56fe34f80b39288e2ce7e035deb518702..5cd3c99d3656067d7d7387514c38d56471191df3 100644
GIT binary patch
literal 20890
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
VC|=6iy!ncdYnLrh6(;Tv{|DL!s{jB1

literal 4338
zcmV<O5Do8%P)<h;3K|Lk000e1NJLTq006iE001!v1^@s6X^dmn00004b3#c}2nYxW
zd<bNS00009a7bBm000Qm000Qm0Xtz6!T<mO8FWQhbW?9;ba!ELWdL_~cP?peYja~^
zaAhuUa%Y?FJQ@H15N}CDK~#90?VWj)6xF%Ff48~^hQTocQQQJVp9EPQKt*sF#iNi!
zA_)#k43cNmqc2K)BKk};lW3wwh@xViCm1!dIP(thSOOuMAtF)P1cxAsfEwcx_5=tr
zGhH`-d{y@C>ZPiBbI#DebNWnI)!n-4ySKjkec!#K2t)naZrIj6D82?90zHRz)<cZ0
z+83&vAS~BWc5b*3I15|%Krs~b3{?4aYWg(gy}lA{5)~*_{VN^N<+lJo0*>-r-2?mr
z)&AkU3EuPTPDfc|(VPH)MLV>f;9T8`R(Ek_)&J$Ct`cn;e*v#scNwT@z?XeeZUJ>G
zW2=^A-I@g(yK<<x22|gK^N9lP@**+o2aG#oQ`YsBX!E2O@cOm=&}tf}3qzK;0NcKe
zD+g~2oM+M63J$6fC~G*HXwvo60uImwJchFGrDpIyLbbER5kazm&uZ*Mw51lf2~r4K
zFq(m1(cE-5R}cAT+EiLA>Kf06*ceciY15?_aF^XEbuYa0I5jn~EZbb74H6gdT5Zv5
z{naR@0LSL3{Etz(mNy5^pjO!lSDxR{6J?J@tCM|8@fUEH*HQLFY6h>&uDK=J8Y1Ac
z*Yzi&W&-^RRL`quHIXZ;)-bEF6A}Az&_e>}4ldvT8h8$6-%?UrN+@P;=tIPQjb!Uc
zzOjLsSnMOF%0uN0C*Xq8>*4S)YK9&Pm9IpbB8qAm30C_e)MWwVvH2&8xu6fDl~u6X
zw5o#gYk>dFvV;?X-fn5Ya-@@HqPLR|WFGQTfO;%o5O6VYGNK;t2R;J+?359tlO7NB
z&2aqyunpMhQ%-;2xHQ*xIr%>f&>olGz)8;c7|;+f-|@h3U;uJYIy&`#2&@EN0}f}X
za|f_1ilr<p`$25$eBk^L4bPUNL4Oz6hNYKct9AveNpl|A3-~3#)5h_gz=J+{CIR1d
zzV89LWJntY#shZ)Ju;-*4?G4;0rqA{cOfv_r+pe&1^fi~eVR12z-XUx{t7Gu9tHm5
zlh(W^hky#7^g|GT%U8*4#@+?|8u$g^IvOotGO!!zO#3XL0$asEFGuqLnzwu!kS|U}
z^L>==2ecHV21^~C$I|Wv&dgI;T@V3#ip;_dPzl@xY(yS@E-0srCBPjyl+z8k4roLM
zfsQ%03m^jA2fPA&4Syfa7lHplI+$DkH-Y~LdI8;mV-r;br4OTZ9q=SjtO?pVD19Bu
zJ{BGGQvp6t%7AC_AA$VnggnIIX|AX1>?a{=($F012N9n8feZ3b&II69pmUC8%>aH#
zdcjV2U!DdII^Q)iith&gg>#UI1)x6x^$6&CWT-DRWuQi5MQVu99;I~=>dc1Ikym0a
z%mI3O&b@?;KAn+{Q~{iajPT}zEeGZy`l%m-5n)ltTi{$or*~1n?LK8}H_EUO-F!GA
zRA#&S0rQbjI2&$7I*Q3oM1AWAv_tO87lBbgom2l`kWt@dzH@yuGUwQlVUlM9Y(}XE
zfYn(xJS4g^w!Q|`FjRrmmfX1s_<ELkM*)|5&P@iYk%!~z*oTmb)c26dr>T2)1?~x1
z?*T-(M**hetvW;*8WFk%;6H(ji0i%}^S22h+XW)DwVrc-LMDp$Awt~joZk&B0<J_R
z=2w$A(X@dF5Or=gFyG&bq3ssXOM$7#<e~`ZzMyYJ=~Ga4YY}w!O{S37X*SNVJ3Ysb
z01x@(c?o%tCf_5yr6Uu205f){BiWmWUk0x6oV%N#0eo?81kAb8TS!OT<&&=wcq7fV
ztvG{12s52NfTf-W^;;bMrobrRVo>9;^{^t;=f}Oq_pXRO9_C?o1<p2(_mMnurDF;3
z2jjR5u`+~3ffJ!AG!x7OnU00Xe8QzWa7M^7F7q7UiCB*ELO46LZ3FhZD5jv*V&t_|
zXpTa0S`q5;V;=BZ<9H-uNeIfhB;N1e5pE(s$8#Lkq#HpdaXpN4>&ShMHQ#d_rd=Hn
zRl{W;a$oXBcEMCyYm{CGY9pdk4$NnxS~33xoCBYAxQ7uH;_U!=Pw*VC4_Wu?p5qf!
zri$|faeccCnb>;UFg;`&QsE6(_STV!<4ElEjpW&6oNctAgKol#F2vR=L5~I9H9yU2
zwH!buQY(-Vu>zQdnC|=*dvx*~hc&}`(|gPFa+c5aI;8En61H6?$9RtOzA`L#SGnDy
zAhs9r7(PpS_i0<<6~u<@G6<Pm`LV}y9M*2^O}{&2ewV$7gXG)fN5%9CbeMMKdQW`G
zV=Rab==Tsi@v{7t+ba195)0vS7yeEYZ~R7Buc$Y@Up&ZTh_%OLJ)+t?K>qw2146dT
zWQV660}z{c-Y7t@leR&>hNY&U)jRnwzg5tJnC{%!zJ)kHzK|i$3KAdYNWz&K$9s<b
zf|i~It|xJ@sUjX1k`ELx#&d3Yi2R2UFQ`i;@U2`MWm33kKHEM>#GZwvr=zldowjDS
z0sn0re;K$uL;5|4kh^pwxL0%>V46w~kv>?;L?bqHQ@8yk$)j$zd<W??E^h&EhAd-&
z=lFi|x8SCL0uErKu-S!DkE57JaoqmJWCmca?)ST&_j!&dAda3)F7DAt)SSuVWR5H}
z`5O|^=TeS%`8ov5pN`9cUwO{eW>L<QB!=*IN8UO;eDYP3*y&SJSOIsjZP0ona6gKd
zi&AItxC!_;VA=-6dSNmN@yJ~dd<B`beF=$8S%}!*%>b`=Nu1;c;VBaB%e|5CTR$wP
zJ)IDj`ss+9d@*AGHrurjs1MmL5H)YI=Uf$HetZ-O2{;j%fSwLqi`>WMh+iUOBx8<d
z!m#KVng&p-(TqXSy}0!kgk6ZsdKtkyo7V!TBEe8DeUOpNkADE)Ao%EQavc)a;aVzg
z0$xDEOViPVWJ^aXRw8OtwpN*Eki{Ce8Rsg1o1ITOP62)nOiY)cI3sux`T$Bj13U>j
zZ*JMokrxoFMGy`mixa|bT(kwTw{HxY&*fv1h2=L$Y<IRaA@hifh=;6Z%Ov0y{QU`D
zMv!3?|C|II9JAsl=*YuGbo&>Q$%rQ|2nT=~Bo1SZPudTGA0QLMuoE~hvq|h&oq(By
z3v-PDYk{93Bj_E(qy2K_G30IbH1MfU+O5RzOWMw*s9RT?r^e-oRR;P}5@Qo`L#f5o
zRC$AWg3^V=iO!q&2PPed=+7Xg#B|YaUb-W3*4+>b!am>=B*b++!8(6u5_cclOzNPx
zN|NKz&9tYI>|q2E>|M^sPxwr_5nsAz6a1cZK;n1$Bk}JQh!g2=h)T4X0QaR82{>Ry
zHMZ`YH@AOo0$!pG@Hwg|DLC@n{v`@b>k{zKaNPdZ5#jbPQ9xR$fIHZZ+aDf8>0+(+
zFVTj`LBOq@po-*~)Ssew9*alGK8h|ICLt5OKayx-vk+^9`RVP+dn<5-aeM_b>o=)J
zCQaTg^9CWd;a3m`$_*q2Az6rHXd&YMpGI;V_5j4GWcnJeK?220>JSIbOk_V2@7$-S
zbNwXa-0dVgXCg?v{1U{<G6z{W?J^H>%bTA*#`TWCPm%SQD-bJ<cSF{3PFv~`OUotr
zkiCE_-36sDfC6sZV`8JQ^<Fg7i?rJROvH`;2I3$w*DhK}kWo8i2da-qo-a%wQJ8*A
za==tKL~zX5i}A?jJOdFEVhphlo2I;($byE$h+TZN)5ab~n&S~uq-h2mK=MN4F^I!&
z2QU_iCoyBmyC9v@TsJwCL^pW^Q6;A#p2-!6HRfU?%{xf^&M3sJxP`b?svHTrnushO
z*@QTv){to9?u%Gfwma=wf>>G7lA9+}t7CvmAo3o>HWGfpX?SEyiOq=H{{m<CszTrj
z#dgxWwSSGct-X{Xo6kfMVXzQ4bCYu}-Kv!`Bp7Nb66+B&&bzkeOMt78cy4zms~;g9
zaVp8tczu!4Hj{gQCNjcC5fj{02z6h-ftWeR0CSD=W~aOZXpg+vo<e@3%S0qhVG!}1
zvK~Q9q_>k8<MIKrZnF$AR}LYA{~=F0xZMM-zK&KWqg0VL@6j=|ZUCmDdA|S^tU_WT
z9zq^|s@3O<5L>KQV0$4CpdN9N-vB(1JYcU4+N38kGR+|I4P`n~&O;nU<{Hhth?<lt
zCjCa_P2#u02jq9uBg^u_IDgJ|+A!C1KImKaTx7I1w}E>bQ4hUqJimm*v(H7W5wDVg
z{7o_y3dI?~rC91Hu!`iFESTG0BO}YT$hy--Dbh?rguxrt)(`POK8mObV~_~IkI4K=
zbp<)oW~eR5Nb42A_N4YGE<jAKvk10DM7dLrJ5afQ&HADwZbaIIsB777{L@70=*A8t
ztA6c~`&o^I2xJUh$iEdu(;k~@(8EyCXmJcRj@#dgJc8Cs$&cH=5_w?1L0*&9BrmCY
z8(G=2%5%QIbL~~&edqHUqIYK6gMF)$_BIlAUULtWrHC+@yHfoJG674aE`g{8n&dfv
zm*bEQ{d?l~@IB{mwe$CAM3s2g$oB%GE1O%d9p(8AnOKBG5Sp8Qjzk8Jg`Tuqk&Tz4
z1lXd&DxgZy866t|x+leoGqGbfiq*&rd>yt<|L;@$c@UWx%|Zlj8_7|8_aH*Gn8YPz
z{fMu$zZtPEX#54-MiwaaLLTH|WQ2Ny_-dim$SeBizy?GZHy|<9-i?J^4j_7ay3yvx
zi1p$fC#@Ns_jg3spGMq8ehi7xk1LQJ25OOzh8K}dqJo6vg1lkoBWlMg#Co(C>CCC3
zEZ;)z{X_T&d4z9W-wTywj`2q+jZ6&u=mP3AwDm8v-d}`iD1gRh3+>w1QUAmTS(f1n
zXlKOibu)<qUXF}nJDksI;=3`OfIQ^)oHXuecaX$oT2W-Qe};Hi>UJc~`7rVpX+$FS
zHXC&}AUjKyAu7vrh@NkD=m-*D@<*iOe2jFOEy#W-E*+fnn~((zlS%H#3y{fOJE!e8
zIOUiubAEHo`7A&tiU&OD6w;ZzVYv0qZ;c{xI8%|u+~(j|=CorC@inm(NC!`e;<>da
zP-b0)(&4rmR?0>*DrBApup7|oOwiftYr)WJJ66>!YKmp6FVPy2@w9$ZJ5<w9Y<({1
zV5Y-R0<Jy)J)N-wUj$&@<}S2+dMVn@WKqZxwI9ukjIC;P-ZCYQU=kIE`c0itO~bM6
zK55b$IRgl|Qis5P4$7ZN`CpLdHl9LrYy`^AW+TZ&w6cLU99`MKS5GSiX_WxdIcDZI
zo<d8r&$b4Z2Aw(-RijZXrL1`x-#k0BYrVccf_>_lpsG<i+&`y^*Y`el^Ag4l`FmFR
zOSD-s{HJ3bL2noWoDX&iyKEW(*ZNItrZ8?$(A6!%vNt-iujL|?szU34wneocW&eSi
z!Pze3D$&OAw`nX`S;?mzs*%_TBfUq!6+1ya&J|}Y$w~LE-*h}QjX>Ky(zn`bM(b5n
zR=!+PM@nQOxY2IT>n9RnBw9O5vOW{=W>9mfh&{n&gY&m<c>S8MKy(D!PTc!WSzBn1
zEalt%vsqbQ;s_(0Ra$FB-MT8UhM`m?*d4LebgmlsQ9)Yw<k~WhvCcuMDr|cfI<|tV
g&dS!VUE&Dj-}vfyEl`O>EdT%j07*qoM6N<$f{c+A$^ZZW

diff --git a/doc/_doxygen/search.html b/doc/_doxygen/search.html
new file mode 100644
index 0000000000..96154ad6f4
--- /dev/null
+++ b/doc/_doxygen/search.html
@@ -0,0 +1,14 @@
+{% extends "sphinx_rtd_theme/search.html" %}
+{% block body %}
+  <div id="fallback" class="admonition tip">
+    <p class="admonition-title">Tip</p>
+    <p>
+      Search results include entries for all documentation sets. Each search
+      result entry is prefixed with the name of the documentation set in
+      which the result is found. For example, the search result
+      "nRF Connect SDK » Getting started" refers to the Getting Started
+      page from the "nRF Connect SDK" documentation set.
+    </p>
+  </div>
+  {{ super() }}
+{% endblock %}
diff --git a/doc/nrf-bm/conf.py b/doc/nrf-bm/conf.py
index f0e1461d3b..131f24f428 100644
--- a/doc/nrf-bm/conf.py
+++ b/doc/nrf-bm/conf.py
@@ -50,7 +50,15 @@
 html_show_sourcelink = True
 html_show_sphinx = False
 
-html_theme_options = {"docset": "nrf-bm", "docsets": utils.ALL_DOCSETS}
+html_theme_options = {
+    "docset": "nrf-bm",
+    "docsets": utils.ALL_DOCSETS,
+    "addons_url": "",
+    "bare_metal_url": "",
+    "ncs_url": "https://nrfconnectdocs.nordicsemi.com/ncs/latest/nrf/",
+    "ncs_label": "nRF Connect SDK Docs",
+    "logo_url": "https://docs.nordicsemi.com",
+}
 
 # Options for intersphinx ------------------------------------------------------
 
diff --git a/doc/requirements.txt b/doc/requirements.txt
index 5b10873c4d..2ef0effc0e 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -4,5 +4,5 @@ Sphinx>=8.1,<8.2
 sphinx-copybutton
 sphinx-tabs
 sphinx-togglebutton
-sphinx-ncs-theme<1.1
+sphinx-ncs-theme<2.1
 west
diff --git a/doc/versions.json b/doc/versions.json
new file mode 100644
index 0000000000..67fd5e4055
--- /dev/null
+++ b/doc/versions.json
@@ -0,0 +1,5 @@
+[
+    "2.0.99",
+    "2.0.0",
+    "1.0.0"
+]