Files
christopherkindl 97c8060917 [docs] Sync docs with @vercel/geistdocs 1.2.0 + 1.2.1 (#364)
* Sync docs template with @vercel/geistdocs 1.2.0 + 1.2.1

Pulls in template updates via `@vercel/geistdocs@1.2.1 update --sync`:

- 1.2.0: new NavbarLogo (oss product switcher variant), geist theme
  tokens + icons, updated docs layout, MobileDocsBar, redesigned navbar
  and mobile menu
- 1.2.1: CommandPrompt UI component, IconCheck / IconCopy fallback
  icons, supporting CSS tokens and @utility rules (material-small,
  text-label-13, text-label-14-mono, text-label-16-mono,
  --ds-shadow-border-small light/dark)

Home page intentionally left untouched because flags-sdk uses a custom
home/[code] routing structure. package.json left untouched to preserve
workspace/catalog references and app-specific deps (flags,
@vercel/toolbar, newer Next).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Cap footer max-w and use LogoFlagsSdk in navbar

- Cap the footer inner row at max-w-[1448px] so it aligns with the
  navbar on very wide screens
- Render the Flags SDK wordmark (LogoFlagsSdk) directly in the navbar
  via the oss NavbarLogo trigger; drop the duplicate entry from the
  product switcher dropdown

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use bg-background-200 for docs container

Matches the navbar background so docs pages (principles, frameworks,
providers, etc.) no longer sit on a lighter surface than the header.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use CommandPrompt humans/agents switcher in hero CTA

Replaces the Get Started button + CopySnippet in the home hero with
the CommandPrompt switcher. Triggers and surface are aligned to the
left via `items-start` on the root so they line up with the hero
heading instead of being centered.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use full npm install command in hero CommandPrompt

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Default hero CommandPrompt to the agents tab

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Bump navbar Flags SDK logo to height 22

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use MobileDocsBar for docs mobile navigation

Disables the default Fumadocs TOC popover and renders the
MobileDocsBar (sidebar trigger + TOC sheet) above the docs title,
matching the geistdocs template.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Override fumadocs primary at :root so prose links render gray-1000

Matches the workflow docs tweak — broadens the fd-primary override
from #nd-toc to :root so in-content links pick up the design-system
foreground color instead of the default blue.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use new --ds-shadow-menu on hero "Try the Flags SDK" card

- Update --ds-shadow-menu to the 4-layer geist menu shadow
- Apply it to the flags-toggle card via `shadow-(--ds-shadow-menu)`;
  drop the stock `shadow-md` and redundant border

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Use LogoFlagsSdk as the app Logo; add AI SDK to product switcher

- Replace the inline triangle SVG + "Flags SDK" text in geistdocs.tsx
  with `<LogoFlagsSdk height={22} />`, so navbar & template consumers
  get the real wordmark
- Revert navbar.tsx to import `Logo` from `@/geistdocs` (single source
  of truth) — the direct LogoFlagsSdk import is no longer needed
- Add `LogoAiSdk` to OSS_PRODUCT_LINKS at the top of the list
  (`ai-sdk.dev`)
- Give LogoAiSdk the same `color` prop pattern as the other SDK logos
- Formatter cleanup in app/[lang]/layout.tsx

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Restore FrameworkSwitcher and theme the Next.js icon

- Re-mount <FrameworkSwitcher /> at the top of the desktop sidebar and
  the mobile Sheet (lost during the 1.2.x template sync)
- Rewrite the Next.js icon to mirror LogoIconNextSvg from
  @vercel/geistcn-assets: circle uses currentColor + text-gray-1000 so
  it auto-inverts per theme; gradient stops for the "N" use
  var(--ds-background-100) so the highlight stays readable in light
  and dark

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Docs: active nav state, geist shadow, restored framework icon + TOC offset

- DesktopMenu: mark nav items active when pathname falls under the
  item's section (match on first three path segments, ignore locale
  prefix); add `data-[active]:text-gray-1000` to the selector
- CodeBlock: restore the `#next` / `#svelte` title-suffix parser so
  framework icons render in code block headers again
- FrameworkSwitcher: apply `--ds-shadow-menu` to the popover content
- geistdocs.css: push `#nd-toc` over with `md:pl-8`

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 19:18:06 +02:00

132 lines
4.3 KiB
TypeScript

"use client";
import type { Node } from "fumadocs-core/page-tree";
import {
SidebarFolder,
SidebarFolderContent,
SidebarFolderLink,
SidebarFolderTrigger,
SidebarItem,
SidebarSeparator,
} from "fumadocs-ui/components/sidebar/base";
import type { SidebarPageTreeComponents } from "fumadocs-ui/components/sidebar/page-tree";
import { useTreeContext, useTreePath } from "fumadocs-ui/contexts/tree";
import { usePathname } from "next/navigation";
import { Fragment, useEffect, useRef } from "react";
import {
Sheet,
SheetContent,
SheetDescription,
SheetHeader,
SheetTitle,
} from "@/components/ui/sheet";
import { FrameworkSwitcher } from "@/components/custom/framework-switcher";
import { useSidebarContext } from "@/hooks/geistdocs/use-sidebar";
import { SearchButton } from "./search";
export const Sidebar = () => {
const { root } = useTreeContext();
const { isOpen, setIsOpen } = useSidebarContext();
const pathname = usePathname();
const previousPathname = useRef(pathname);
useEffect(() => {
if (pathname !== previousPathname.current) {
setIsOpen(false);
previousPathname.current = pathname;
}
}, [pathname, setIsOpen]);
const renderSidebarList = (items: Node[]) =>
items.map((item) => {
if (item.type === "separator") {
return <Separator item={item} key={item.$id} />;
}
if (item.type === "folder") {
const children = renderSidebarList(item.children);
return (
<Folder item={item} key={item.$id}>
{children}
</Folder>
);
}
return <Item item={item} key={item.$id} />;
});
return (
<div
className="pointer-events-none sticky top-(--fd-docs-row-1) z-20 h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] [grid-area:sidebar] *:pointer-events-auto max-md:hidden md:layout:[--fd-sidebar-width:268px]"
data-sidebar-placeholder
>
<div className="h-full overflow-y-auto px-4 pt-12 pb-4">
<FrameworkSwitcher />
<Fragment key={root.$id}>{renderSidebarList(root.children)}</Fragment>
</div>
<Sheet onOpenChange={setIsOpen} open={isOpen}>
<SheetContent className="gap-0" side="left">
<SheetHeader className="mt-8">
<SheetTitle className="sr-only">Mobile Menu</SheetTitle>
<SheetDescription className="sr-only">
Navigation for the documentation.
</SheetDescription>
<SearchButton onClick={() => setIsOpen(false)} />
</SheetHeader>
<div className="flex-1 overflow-y-auto px-4 pb-4">
<FrameworkSwitcher />
{renderSidebarList(root.children)}
</div>
</SheetContent>
</Sheet>
</div>
);
};
export const Folder: SidebarPageTreeComponents["Folder"] = ({
children,
item,
}) => {
const path = useTreePath();
const defaultOpen = item.defaultOpen ?? path.includes(item);
return (
<SidebarFolder defaultOpen={defaultOpen}>
{item.index ? (
<SidebarFolderLink
className="flex items-center gap-2 text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground data-[active=true]:text-foreground [&_svg]:size-3.5"
external={item.index.external}
href={item.index.url}
>
{item.icon}
{item.name}
</SidebarFolderLink>
) : (
<SidebarFolderTrigger className="flex items-center gap-2 text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground [&_svg]:size-3.5">
{item.icon}
{item.name}
</SidebarFolderTrigger>
)}
<SidebarFolderContent className="ml-2">{children}</SidebarFolderContent>
</SidebarFolder>
);
};
export const Item: SidebarPageTreeComponents["Item"] = ({ item }) => (
<SidebarItem
className="block w-full truncate text-pretty py-1.5 text-muted-foreground text-sm transition-colors hover:text-foreground data-[active=true]:text-foreground"
external={item.external}
href={item.url}
icon={item.icon}
>
{item.name}
</SidebarItem>
);
export const Separator: SidebarPageTreeComponents["Separator"] = ({ item }) => (
<SidebarSeparator className="mt-4 mb-2 flex items-center gap-2 px-0 font-medium text-sm first-child:mt-0">
{item.icon}
{item.name}
</SidebarSeparator>
);