Skip to content

Conversation

@tstirrat15
Copy link
Collaborator

@tstirrat15 tstirrat15 commented Dec 6, 2025

Description

Maintenance, mostly. We were on v2, which is more than a year old; we moved to v3 but that broke some things, especially around search. This brings us onto v4.

Changes

Will annotate. It was an annoyingly large set of changes.

Testing

Review. See that the deployment looks good.

@vercel
Copy link
Contributor

vercel bot commented Dec 6, 2025

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

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 6, 2025 6:34pm

Copy link
Collaborator Author

@tstirrat15 tstirrat15 left a comment

Choose a reason for hiding this comment

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

See comments

@@ -1,15 +1,15 @@
import type { MetaRecord } from "nextra";
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Nextra fails cryptically when you have a _meta.ts file with the wrong shape. Adding this type assertion helps prevent that.

"grpc-api": {
title: "gRPC API Reference",
href: "https://buf.build/authzed/api/docs/main:authzed.api.v1",
newWindow: true,
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Nextra automatically opens external links in new tabs now.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This file was just moved.

@@ -1,4 +1,4 @@
import YouTube from "react-youtube";
import YouTube from "@/components/youtube-wrapper";
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

We needed to wrap this component because it's an old-style class component and next doesn't like them in server components, which is what these mdx files turn into.

Comment on lines -30 to -32
- [spicedb datastore](#reference-spicedb-datastore) - datastore operations
- [spicedb lsp](#reference-spicedb-lsp) - serve language server protocol
- [spicedb man](#reference-spicedb-man) - Generate man page
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

These changes are from running prettier - they should be noops.

Comment on lines +38 to +39
// using the metadataBase field.
canonical: "./",
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Thanks, next. 🪄

process.env.NEXT_PUBLIC_ENABLE_SEARCH_BLOG_INTEGRATION === "true";

const navbar = (
<Navbar
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

There's a bunch of components that we were reimplementing that we can now pull directly from Nextra. Navbar and Footer are examples.

Comment on lines +61 to +64
color={{
hue: { dark: 45, light: 290 },
saturation: { dark: 100, light: 100 },
}}
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This is where the color part of the old themeconfig went.

Comment on lines +69 to +71
<Banner dismissible={false}>
<BannerContents />
</Banner>
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This is where the banner part of the old themeconfig went.

Comment on lines +101 to +104
<OurLayout>
<SpeedInsights />
<Providers>{children}</Providers>
</OurLayout>
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This is where the old app.tsx bits went.

@miparnisari miparnisari merged commit aae226d into main Dec 7, 2025
10 of 11 checks passed
@miparnisari miparnisari deleted the nextra-v4-upgrade branch December 7, 2025 19:39
@github-actions github-actions bot locked and limited conversation to collaborators Dec 7, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants