feat(integration): add next-app-router-bundled-ui integration template

jacekradko · jacekradko · commit a2265262b111 · 2026-02-11T16:51:37.000-06:00
Add a Next.js App Router integration template that uses `@clerk/ui` bundled UI
via `ui={ui}` on `&lt;ClerkProvider&gt;`. Includes sign-in, sign-up, user-button, and
theme test pages for dark, neobrutalism, shadesOfPurple, and shadcn themes.
diff --git a/integration/presets/longRunningApps.ts b/integration/presets/longRunningApps.ts
@@ -36,6 +36,11 @@ export const createLongRunningApps = () => {
     { id: 'next.appRouter.withNeedsClientTrust', config: next.appRouter, env: envs.withNeedsClientTrust },
     { id: 'next.appRouter.withSharedUIVariant', config: next.appRouter, env: envs.withSharedUIVariant },
 
+    /**
+     * NextJS apps - bundled UI
+     */
+    { id: 'next.appRouterBundledUI.withEmailCodes', config: next.appRouterBundledUI, env: envs.withEmailCodes },
+
     /**
      * NextJS apps - cache components
      */
diff --git a/integration/presets/next.ts b/integration/presets/next.ts
@@ -36,6 +36,21 @@ const appRouterAPWithClerkNextV6 = appRouterQuickstartV6
   .setName('next-app-router-ap-clerk-next-v6')
   .addDependency('@clerk/nextjs', '6');
 
+const appRouterBundledUI = applicationConfig()
+  .setName('next-app-router-bundled-ui')
+  .useTemplate(templates['next-app-router-bundled-ui'])
+  .setEnvFormatter('public', key => `NEXT_PUBLIC_${key}`)
+  .addScript('setup', constants.E2E_NPM_FORCE ? 'pnpm install --force' : 'pnpm install')
+  .addScript('dev', 'pnpm dev')
+  .addScript('build', 'pnpm build')
+  .addScript('serve', 'pnpm start')
+  .addDependency('next', constants.E2E_NEXTJS_VERSION)
+  .addDependency('react', constants.E2E_REACT_VERSION)
+  .addDependency('react-dom', constants.E2E_REACT_DOM_VERSION)
+  .addDependency('@clerk/nextjs', constants.E2E_CLERK_JS_VERSION || linkPackage('nextjs'))
+  .addDependency('@clerk/shared', linkPackage('shared'))
+  .addDependency('@clerk/ui', constants.E2E_CLERK_UI_VERSION || linkPackage('ui'));
+
 const cacheComponents = applicationConfig()
   .setName('next-cache-components')
   .useTemplate(templates['next-cache-components'])
@@ -54,5 +69,6 @@ export const next = {
   appRouterAPWithClerkNextLatest,
   appRouterAPWithClerkNextV6,
   appRouterQuickstartV6,
+  appRouterBundledUI,
   cacheComponents,
 } as const;
diff --git a/integration/templates/index.ts b/integration/templates/index.ts
@@ -7,6 +7,7 @@ export const templates = {
   'next-app-router': resolve(__dirname, './next-app-router'),
   'next-cache-components': resolve(__dirname, './next-cache-components'),
   'next-app-router-quickstart': resolve(__dirname, './next-app-router-quickstart'),
+  'next-app-router-bundled-ui': resolve(__dirname, './next-app-router-bundled-ui'),
   'next-app-router-quickstart-v6': resolve(__dirname, './next-app-router-quickstart-v6'),
   'react-cra': resolve(__dirname, './react-cra'),
   'react-vite': resolve(__dirname, './react-vite'),
diff --git a/integration/templates/next-app-router-bundled-ui/.gitignore b/integration/templates/next-app-router-bundled-ui/.gitignore
@@ -0,0 +1,35 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
diff --git a/integration/templates/next-app-router-bundled-ui/next.config.js b/integration/templates/next-app-router-bundled-ui/next.config.js
@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+module.exports = nextConfig;
diff --git a/integration/templates/next-app-router-bundled-ui/package.json b/integration/templates/next-app-router-bundled-ui/package.json
@@ -0,0 +1,23 @@
+{
+  "name": "next-app-router-bundled-ui",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "next build",
+    "dev": "next dev",
+    "lint": "next lint",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@types/node": "^20.12.12",
+    "@types/react": "18.3.12",
+    "@types/react-dom": "18.3.1",
+    "next": "^15.0.1",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  }
+}
diff --git a/integration/templates/next-app-router-bundled-ui/public/next.svg b/integration/templates/next-app-router-bundled-ui/public/next.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>
diff --git a/integration/templates/next-app-router-bundled-ui/public/vercel.svg b/integration/templates/next-app-router-bundled-ui/public/vercel.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 283 64"><path fill="black" d="M141 16c-11 0-19 7-19 18s9 18 20 18c7 0 13-3 16-7l-7-5c-2 3-6 4-9 4-5 0-9-3-10-7h28v-3c0-11-8-18-19-18zm-9 15c1-4 4-7 9-7s8 3 9 7h-18zm117-15c-11 0-19 7-19 18s9 18 20 18c6 0 12-3 16-7l-8-5c-2 3-5 4-8 4-5 0-9-3-11-7h28l1-3c0-11-8-18-19-18zm-10 15c2-4 5-7 10-7s8 3 9 7h-19zm-39 3c0 6 4 10 10 10 4 0 7-2 9-5l8 5c-3 5-9 8-17 8-11 0-19-7-19-18s8-18 19-18c8 0 14 3 17 8l-8 5c-2-3-5-5-9-5-6 0-10 4-10 10zm83-29v46h-9V5h9zM37 0l37 64H0L37 0zm92 5-27 48L74 5h10l18 30 17-30h10zm59 12v10l-3-1c-6 0-10 4-10 10v15h-9V17h9v9c0-5 6-9 13-9z"/></svg>
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/favicon.ico b/integration/templates/next-app-router-bundled-ui/src/app/favicon.ico
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/globals.css b/integration/templates/next-app-router-bundled-ui/src/app/globals.css
@@ -0,0 +1,78 @@
+:root {
+  --max-width: 1100px;
+  --border-radius: 12px;
+  --font-mono:
+    ui-monospace, Menlo, Monaco, 'Cascadia Mono', 'Segoe UI Mono', 'Roboto Mono', 'Oxygen Mono', 'Ubuntu Monospace',
+    'Source Code Pro', 'Fira Mono', 'Droid Sans Mono', 'Courier New', monospace;
+
+  --foreground-rgb: 0, 0, 0;
+  --background-start-rgb: 214, 219, 220;
+  --background-end-rgb: 255, 255, 255;
+
+  --primary-glow: conic-gradient(
+    from 180deg at 50% 50%,
+    #16abff33 0deg,
+    #0885ff33 55deg,
+    #54d6ff33 120deg,
+    #0071ff33 160deg,
+    transparent 360deg
+  );
+  --secondary-glow: radial-gradient(rgba(255, 255, 255, 1), rgba(255, 255, 255, 0));
+
+  --tile-start-rgb: 239, 245, 249;
+  --tile-end-rgb: 228, 232, 233;
+  --tile-border: conic-gradient(#00000080, #00000040, #00000030, #00000020, #00000010, #00000010, #00000080);
+
+  --callout-rgb: 238, 240, 241;
+  --callout-border-rgb: 172, 175, 176;
+  --card-rgb: 180, 185, 188;
+  --card-border-rgb: 131, 134, 135;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --foreground-rgb: 255, 255, 255;
+    --background-start-rgb: 0, 0, 0;
+    --background-end-rgb: 0, 0, 0;
+
+    --primary-glow: radial-gradient(rgba(1, 65, 255, 0.4), rgba(1, 65, 255, 0));
+    --secondary-glow: linear-gradient(to bottom right, rgba(1, 65, 255, 0), rgba(1, 65, 255, 0), rgba(1, 65, 255, 0.3));
+
+    --tile-start-rgb: 2, 13, 46;
+    --tile-end-rgb: 2, 5, 19;
+    --tile-border: conic-gradient(#ffffff80, #ffffff40, #ffffff30, #ffffff20, #ffffff10, #ffffff10, #ffffff80);
+
+    --callout-rgb: 20, 20, 20;
+    --callout-border-rgb: 108, 108, 108;
+    --card-rgb: 100, 100, 100;
+    --card-border-rgb: 200, 200, 200;
+  }
+}
+
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+}
+
+body {
+  color: rgb(var(--foreground-rgb));
+  background: linear-gradient(to bottom, transparent, rgb(var(--background-end-rgb))) rgb(var(--background-start-rgb));
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  html {
+    color-scheme: dark;
+  }
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/layout.tsx b/integration/templates/next-app-router-bundled-ui/src/app/layout.tsx
@@ -0,0 +1,28 @@
+import './globals.css';
+import { Inter } from 'next/font/google';
+import { ClerkProvider } from '@clerk/nextjs';
+import { ui } from '@clerk/ui';
+
+const inter = Inter({ subsets: ['latin'] });
+
+export const metadata = {
+  title: 'Bundled UI Test App',
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <ClerkProvider
+      ui={ui}
+      appearance={{
+        options: {
+          showOptionalFields: true,
+          socialButtonsVariant: 'blockButton',
+        },
+      }}
+    >
+      <html lang='en'>
+        <body className={inter.className}>{children}</body>
+      </html>
+    </ClerkProvider>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/page.tsx b/integration/templates/next-app-router-bundled-ui/src/app/page.tsx
@@ -0,0 +1,17 @@
+import { Show, SignInButton, SignUpButton, UserButton } from '@clerk/nextjs';
+
+export default function Home() {
+  return (
+    <header>
+      <Show when='signed-out'>
+        <p>signed-out-state</p>
+        <SignInButton />
+        <SignUpButton />
+      </Show>
+      <Show when='signed-in'>
+        <p>signed-in-state</p>
+        <UserButton />
+      </Show>
+    </header>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/sign-in/[[...catchall]]/page.tsx b/integration/templates/next-app-router-bundled-ui/src/app/sign-in/[[...catchall]]/page.tsx
@@ -0,0 +1,14 @@
+import { SignIn } from '@clerk/nextjs';
+
+export default function Page() {
+  return (
+    <div>
+      <SignIn
+        routing={'path'}
+        path={'/sign-in'}
+        signUpUrl={'/sign-up'}
+        fallback={<>Loading sign in</>}
+      />
+    </div>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/sign-up/[[...catchall]]/page.tsx b/integration/templates/next-app-router-bundled-ui/src/app/sign-up/[[...catchall]]/page.tsx
@@ -0,0 +1,14 @@
+import { SignUp } from '@clerk/nextjs';
+
+export default function Page() {
+  return (
+    <div>
+      <SignUp
+        routing={'path'}
+        path={'/sign-up'}
+        signInUrl={'/sign-in'}
+        fallback={<>Loading sign up</>}
+      />
+    </div>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/themes/page.tsx b/integration/templates/next-app-router-bundled-ui/src/app/themes/page.tsx
@@ -0,0 +1,43 @@
+'use client';
+
+import { SignIn } from '@clerk/nextjs';
+import { dark, neobrutalism, shadesOfPurple, shadcn } from '@clerk/ui/themes';
+
+export default function ThemesPage() {
+  return (
+    <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '2rem', padding: '2rem' }}>
+      <div>
+        <h2>Dark</h2>
+        <SignIn
+          appearance={{ baseTheme: dark }}
+          routing='hash'
+          fallback={<>Loading dark theme</>}
+        />
+      </div>
+      <div>
+        <h2>Neobrutalism</h2>
+        <SignIn
+          appearance={{ baseTheme: neobrutalism }}
+          routing='hash'
+          fallback={<>Loading neobrutalism theme</>}
+        />
+      </div>
+      <div>
+        <h2>Shades of Purple</h2>
+        <SignIn
+          appearance={{ baseTheme: shadesOfPurple }}
+          routing='hash'
+          fallback={<>Loading shadesOfPurple theme</>}
+        />
+      </div>
+      <div>
+        <h2>Shadcn</h2>
+        <SignIn
+          appearance={{ baseTheme: shadcn }}
+          routing='hash'
+          fallback={<>Loading shadcn theme</>}
+        />
+      </div>
+    </div>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/app/user-button/page.tsx b/integration/templates/next-app-router-bundled-ui/src/app/user-button/page.tsx
@@ -0,0 +1,9 @@
+import { UserButton } from '@clerk/nextjs';
+
+export default function Page() {
+  return (
+    <div>
+      <UserButton fallback={<>Loading user button</>} />
+    </div>
+  );
+}
diff --git a/integration/templates/next-app-router-bundled-ui/src/middleware.ts b/integration/templates/next-app-router-bundled-ui/src/middleware.ts
@@ -0,0 +1,7 @@
+import { clerkMiddleware } from '@clerk/nextjs/server';
+
+export default clerkMiddleware();
+
+export const config = {
+  matcher: ['/((?!.*\\..*|_next).*)', '/', '/(api|trpc)(.*)'],
+};
diff --git a/integration/templates/next-app-router-bundled-ui/tsconfig.json b/integration/templates/next-app-router-bundled-ui/tsconfig.json
@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}
