Skip to content

Conversation

@tg339
Copy link
Member

@tg339 tg339 commented Nov 10, 2025

Note

Introduces feature‑flagged navigation, a Pagefind‑powered command palette, a templates API/grid, extensive new MDX components, and multiple UI/infra refinements across the docs app.

  • Navigation & Feature Flags:
    • Add Vercel Flags discovery endpoint at src/app/.well-known/vercel/flags/route.ts and flags (show-hosting-section, show-guides-section, show-ai-section) via src/flags.ts.
    • Evaluate flags in src/app/layout.tsx and src/app/page.tsx; pass to TopNav to conditionally show sections.
    • Make slug page dynamic and adjust article layout (src/app/[...slug]/page.tsx).
    • Extend navigation config with new guides section and many guide pages (src/config/navigation.ts).
  • Search:
    • Replace legacy search with a command‑palette modal using Pagefind: src/components/search/command-search.tsx, src/components/ui/command.tsx; wired into TopNav (⌘/Ctrl+K).
  • Templates Catalog:
    • Add templates metadata loader (src/lib/templates.ts, src/lib/template-types.ts), API endpoint src/app/api/templates/route.ts, and UI (TemplateCard, TemplateGrid, TemplatesGridServer).
  • MDX Enhancements:
    • Expand MDXRenderer with new components: MuxVideo, FileTree (+ subcomponents), changelog category components, ExportRequirement, tabs/badges, SourceCodeLink, etc.
    • New MDX components and utilities under src/components/mdx/*.
  • UI/UX & Infra Tweaks:
    • Add scroll restoration (src/components/scroll-restoration.tsx) and toast system (src/components/ui/sonner.tsx).
    • Improve TOC active‑heading logic and layout (src/components/navigation/toc-nav.tsx); sidebar/spacing tweaks.
    • Code block and editor rendering overflow/line‑number/stability improvements.
    • Minor layout/style updates (smooth scrolling, Tailwind content paths).
  • Removals:
    • Delete src/app/dashboard/page.tsx and old migrate script.
  • Deps:
    • Install Flags SDK, CMDK, Mux player, Sonner, Vercel Toolbar, TOML parser, and related packages; update lockfile.

Written by Cursor Bugbot for commit 1f7dace. This will update automatically on new commits. Configure here.

@linear
Copy link

linear bot commented Nov 10, 2025

@vercel
Copy link

vercel bot commented Nov 10, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs-v2 Ready Ready Preview Comment Nov 12, 2025 7:05pm
framework-docs Ready Ready Preview Comment Nov 12, 2025 7:05pm
moosestack-framework-docs-v2 Ready Ready Preview Comment Nov 12, 2025 7:05pm


const displayTitle = title || variantProps.title;

if (compact) {
return (
<Alert variant={variantProps.variant} className={cn("my-2", className)}>
{icon && <Icon className="h-4 w-4" />}
{!href && icon && <Icon className="h-4 w-4" />}
{href && icon && <Icon className="h-4 w-4 mt-0.5" />}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Falsy Props Break Icon Rendering Conditions

The compact mode renders the icon twice with mutually exclusive conditions checking the icon prop instead of the resolved Icon component. When icon={false}, Icon becomes undefined but these conditions check the original icon prop. This works correctly, but if someone passes a custom component that is falsy (like icon={0} or icon={''} empty string), the condition would fail to render even though a fallback icon exists in the resolved Icon variable. The checks should verify that Icon is defined rather than checking the raw icon prop value.

Fix in Cursor Fix in Web

OFFSET {offset}
"""

results = await client.query.execute(query, params=params_dict)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Parameter Scope Error in Query String

The Python query uses f-string interpolation for {limit} and {offset} on lines 662-663, but these variables aren't defined in the function scope. The code adds limit and offset to params_dict but then tries to reference them as Python variables in the f-string instead of as ClickHouse query parameters. This will cause a NameError at runtime. The {limit} and {offset} should either be parameterized like {limit} in the query string (without f-string interpolation for those placeholders), or the variables need to be extracted from params_dict before the query string is constructed.

Fix in Cursor Fix in Web

ctaLabel="Details"
secondaryCtaLink="https://github.com/514-labs/area-code/tree/main/ufa-lite"
secondaryCtaLabel="Github →"
badge={{ variant: "default", text: "ClickHouse Cloud demo" }}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: CTACard anchor links lead nowhere.

The CTACards have ctaLink values pointing to anchor links like #plane-transponder-demo, #postgres-clickhouse-cdc, #foobar-ufa, and #foobar-ufa-lite, but these corresponding sections with matching IDs don't exist anywhere on the page. When users click the "Details" button, the links won't navigate to any content, resulting in broken navigation. Either the anchor sections need to be added to the page, or the ctaLink props should be removed/changed to external links.

Fix in Cursor Fix in Web

code sizeing

new batch

data insertion

versioning & migration

next batch

next batch

fix mdx-rendered and adding next batch of files

adding api files

fixed some language rendering and added more pages

added workflows files

added other workflow files

streaming files

added additional frameworks

added new batch

added top level files

data modeling

all files migrated

initial changelog

addressing cursor comments

fix tabs

added a bit of padding to the nav

added sonner for language change

fix TOC

fix the build

add ts ignore to mux player

removed top nav

fix TOC challenges

added templates to new docs

split server & client components

moved to static api route instead

we got search

udpated errror handling

updaign

adjusting

added default

added sitemap

update sitemap config

caching gh stars

fixing issues

attempt build fix

another attempt at build fix

yet another

attempt yet another fix

yet another

centering

fixed issues

fixed search

variety of fixes

prevent overscroll

fix content wrapper for code editor and consistent heights

better search highlights

fix alignement of text in sidebar submenu

added feature flags

add flags wellknown enpoint

fixed flags

added ai section feature flag

made text smalelr in header

tiny spacing tweaks

fix changelog styles

initial guides
console.error(
`Failed to highlight code for language "${language}":`,
error,
);
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: Debugging Fallback Errors Is Impossible

The error logging in the fallback error handler references the wrong variable. The console.error logs error from the outer catch block instead of fallbackError from the inner catch block, making it impossible to debug failures in the text fallback highlighting.

Fix in Cursor Fix in Web

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants