@primer/doctocat-nextjs 0.0.0-20250624173343 → 0.0.0-20250624182848

package/CHANGELOG.md

@@ -1,17 +1,16 @@
 # @primer/doctocat-nextjs
 
-## 0.0.0-20250624173343
+## 0.0.0-20250624182848
 
 ### Patch Changes
 
 - Fake entry to force publishing
 
-## 0.0.0-20250624173341
+## 0.0.0-20250624182846
 
 ### Patch Changes
 
-- [#48](https://github.com/primer/doctocat-nextjs/pull/48) [`593f5a3`](https://github.com/primer/doctocat-nextjs/commit/593f5a36b1f426d24f17e13a2784645de2571f84) Thanks [@rezrah](https://github.com/rezrah)! - - Fix inline code font-size in markdown headings. Now inherits size used in the heading.
-  - Increased spacing below React code blocks, which was previously too small.
+- [`816b6a5`](https://github.com/primer/doctocat-nextjs/commit/816b6a5af42f0c6e4ff7ae5473440e153f0df600) Thanks [@rezrah](https://github.com/rezrah)! - Add `menu-position` frontmatter support for custom sidebar navigation ordering
 
 ## 0.5.3
 

package/components/layout/code-block/ReactCodeBlock.module.css

@@ -1,5 +1,4 @@
 .CodeBlock {
-  --spacing: var(--base-size-40);
   margin-block: var(--base-size-24);
   background-color: var(--brand-color-canvas-default);
   border: var(--brand-borderWidth-thin) solid var(--brand-color-border-default);

package/components/layout/sidebar/Sidebar.tsx

@@ -82,7 +82,29 @@ export function Sidebar({pageMap}: SidebarProps) {
                 <NextLink href={item.route}>{subNavName}</NextLink>
               </NavList.GroupHeading>
               {item.children
-                .sort((a, b) => ((a as MdxFile).name === 'index' ? -1 : (b as MdxFile).name === 'index' ? 1 : 0)) // puts index page first
+                .sort((a, b) => {
+                  // make sure index page is first
+                  if ((a as MdxFile).name === 'index') return -1
+                  if ((b as MdxFile).name === 'index') return 1
+
+                  // Check for menu-position property in frontmatter
+                  const aPos = (a as MdxFile).frontMatter?.['menu-position']
+                  const bPos = (b as MdxFile).frontMatter?.['menu-position']
+
+                  // If both have menu-position, sort by menu-position
+                  if (typeof aPos === 'number' && typeof bPos === 'number') {
+                    return aPos - bPos
+                  }
+
+                  // If only one has menu-position, it comes first
+                  if (typeof aPos === 'number') return -1
+                  if (typeof bPos === 'number') return 1
+
+                  // Neither has menu-position, sort alphabetically by title or name
+                  const aTitle = (a as MdxFile).frontMatter?.title || (a as MdxFile).name
+                  const bTitle = (b as MdxFile).frontMatter?.title || (b as MdxFile).name
+                  return aTitle.localeCompare(bTitle)
+                })
                 // only show index page if it has show-tabs
                 .filter(child => (child as MdxFile).name !== 'index' || hasShowTabs(child as ExtendedPageItem))
                 .map(child => {

package/css/prose.module.css

@@ -211,11 +211,6 @@
   background-color: var(--base-color-scale-indigo-0);
 }
 
-/* Inline code inside headings should inherit font-size */
-.Prose :is(h1, h2, h3, h4, h5, h6):has(code) code:not(:global(.custom-component) code) {
-  font-size: inherit;
-}
-
 [data-color-mode='dark'] .Prose code:not(:global(.custom-component) code) {
   background-color: var(--base-color-scale-indigo-9);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primer/doctocat-nextjs",
-  "version": "0.0.0-20250624173343",
+  "version": "0.0.0-20250624182848",
   "description": "A Next.js theme for building Primer documentation sites",
   "main": "index.js",
   "type": "module",

package/types.ts

@@ -31,6 +31,7 @@ export type FrontMatter = {
   description?: string
   filePath?: string
   keywords?: string[]
+  order?: number
   related?: {
     title: string
     href: string