uniform-nextjs-app-router
Guides integration of Uniform CMS with Next.js App Router using the @uniformdev/next-app-router v2 SDK and React Server Components. Covers project setup, environment variables, required edge middleware and advanced routing, the uniform/[code] composition route, component mapping with resolveComponent, rendering slots and parameters, asset handling, client-side personalization with quirks and scores, contextual editing preview, Next.js 16 cacheComponents, composition data enhancement, and adapter compatibility mode. Use when adding Uniform to a Next.js 16 App Router project, creating Uniform-powered React server components, or configuring live preview, personalization, and caching.
Install
With your agent
Install OMGSkills skill "uniformdev/agent-skills:skills/uniform-nextjs-app-router" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/uniformdev/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/uniform-nextjs-app-router ~/.claude/skills/uniform-nextjs-app-routerFrom README
Uniform with Next.js App Router Integration guide for wiring Uniform CMS to a Next.js application using the App Router. The integration uses React Server Components and the @uniformdev/next-app-router package (the v2 SDK, version 20.58.0 or later). Requirements Next.js 16+ and App Router only (this v2 SDK does not support the Page Router). Node.js 22+. A Uniform project with compositions. On Next.js 15 + Page Router, use the Page Router SDK instead. Migrating Page Router → App Router? Contact Uniform support. Scaffold a working project instead of integrating from scratch: Select Next.js, then the Component Starter Kit (full-featured) or Hello World (minimal). Otherwise follow the manual in references/ .md. Required packages @uniformdev/next-app-router (version 20.58.0+), @uniformdev/canvas and @uniformdev/cli. For advanced client-side context customization, also add @uniformdev/next-app-router-client and @uniformdev/context. Architecture essentials Middleware is required.
More from this repo
uniform-content-modeling
Best practices for content modeling in Uniform — designing content types with well-chosen fields, validations, and...
uniform-enrichment-recommendations
Used to add personalized, relevance-ranked content recommendations to a Uniform + React/Next.js project by boosting...
uniform-experience-modeling
Best practices for experience modeling in Uniform — designing component definitions with well-chosen parameters, slots,...