Sitemap, Robots, Routing & Static Params

import {
  generateNoxionSitemap,
  generateNoxionRobots,
  generateNoxionStaticParams,
  generateNoxionRoutes,
  resolvePageType,
  buildPageUrl,
  generateStaticParamsForRoute,
} from "@noxion/adapter-nextjs";

---

generateNoxionSitemap()

Generates a sitemap with page-type-aware priority levels.

Signature

function generateNoxionSitemap(
  pages: NoxionPage[],
  config: NoxionConfig,
  routePrefix?: Record<string, string>
): MetadataRoute.Sitemap

Page-type priorities

Page type	Priority
Homepage	1.0
Blog posts	0.8
Docs pages	0.7
Portfolio projects	0.6
Tag pages	0.5

Usage

// app/sitemap.ts
import { generateNoxionSitemap } from "@noxion/adapter-nextjs";

export default async function sitemap() {
  const pages = await getAllPages();
  return generateNoxionSitemap(pages, siteConfig);
}

---

generateNoxionRoutes()

Generates route configurations for all collections. Used for multi-page-type routing.

Signature

function generateNoxionRoutes(
  config: NoxionConfig
): NoxionRouteConfig[]

Returns

interface NoxionRouteConfig {
  pageType: string;
  pathPrefix: string;
  paramName: string;
}

---

resolvePageType()

Determines the page type from a URL path by matching against configured route prefixes.

Signature

function resolvePageType(
  path: string,
  routes: NoxionRouteConfig[]
): NoxionRouteConfig | undefined

Example

const routes = generateNoxionRoutes(config);

resolvePageType("/docs/getting-started", routes);
// => { pageType: "docs", pathPrefix: "/docs", paramName: "slug" }

---

buildPageUrl()

Builds the full URL path for a page, using its collection's pathPrefix.

Signature

function buildPageUrl(
  page: NoxionPage,
  routes: NoxionRouteConfig[]
): string

Example

const routes = generateNoxionRoutes(config);
buildPageUrl(docsPage, routes);      // "/docs/getting-started"
buildPageUrl(blogPage, routes);      // "/my-post"
buildPageUrl(portfolioPage, routes); // "/portfolio/noxion" (if pathPrefix is set to /portfolio)

---

generateStaticParamsForRoute()

Generates static params for a specific page type route.

Signature

function generateStaticParamsForRoute(
  pages: NoxionPage[],
  route: NoxionRouteConfig
): { slug: string }[]

---

generateNoxionRobots()

Generates robots.txt with sitemap reference.

function generateNoxionRobots(config: NoxionConfig): MetadataRoute.Robots

Generated robots.txt

User-agent: *
Allow: /
Disallow: /api/
Disallow: /_next/

Sitemap: https://mysite.com/sitemap.xml
Host: https://mysite.com

---

generateNoxionStaticParams()

Generates { slug: string }[] for Next.js generateStaticParams().

async function generateNoxionStaticParams(
  client: NotionAPI,
  rootPageId: string
): Promise<{ slug: string }[]>

Usage

// app/[slug]/page.tsx
export async function generateStaticParams() {
  return generateNoxionStaticParams(notion, siteConfig.rootNotionPageId);
}