From agent-almanac
Scaffolds a new Next.js application with App Router, TypeScript, Tailwind CSS, and ESLint. Use when starting a new web app, creating a React frontend with SSR, or building a full-stack project with API routes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agent-almanac:scaffold-nextjs-appThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Create a new Next.js application with App Router, TypeScript, and production-ready defaults.
Create a new Next.js application with App Router, TypeScript, and production-ready defaults.
npx create-next-app@latest my-app \
--typescript \
--tailwind \
--eslint \
--app \
--src-dir \
--import-alias "@/*"
Answer prompts or use flags to set all options non-interactively.
Expected: Project directory created with all dependencies installed.
On failure: Check Node.js version (node --version, must be >= 18.17). Ensure npx is available. If the command hangs on prompts, add the --use-npm flag (or --use-pnpm/--use-yarn) to skip the package manager prompt.
my-app/
├── src/
│ ├── app/
│ │ ├── layout.tsx # Root layout
│ │ ├── page.tsx # Home page
│ │ ├── globals.css # Global styles
│ │ └── favicon.ico
│ └── lib/ # Shared utilities (create manually)
├── public/ # Static assets
├── next.config.ts # Next.js configuration
├── tailwind.config.ts # Tailwind configuration
├── tsconfig.json # TypeScript configuration
├── package.json
└── .eslintrc.json
Expected: All listed directories and files are present.
On failure: If src/ directory is missing, the --src-dir flag was not passed. Re-run create-next-app with the flag, or move files manually into src/app/.
Edit next.config.ts for project needs:
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
// Enable React strict mode
reactStrictMode: true,
// Image optimization domains
images: {
remotePatterns: [
{
protocol: "https",
hostname: "example.com",
},
],
},
};
export default nextConfig;
Expected: next.config.ts saved without TypeScript errors.
On failure: If the file uses .js extension instead of .ts, rename it. Ensure NextConfig type is imported from "next".
Create common directories:
mkdir -p src/app/api
mkdir -p src/components
mkdir -p src/lib
mkdir -p src/types
Expected: All four directories created under src/.
On failure: If src/ does not exist, create it first or adjust paths to match the project structure (non-src layout uses app/ at the root).
Edit src/app/layout.tsx:
import type { Metadata } from "next";
import { Inter } from "next/font/google";
import "./globals.css";
const inter = Inter({ subsets: ["latin"] });
export const metadata: Metadata = {
title: "My Application",
description: "Application description",
};
export default function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
<html lang="en">
<body className={inter.className}>{children}</body>
</html>
);
}
Expected: Layout renders with the Inter font and wraps all pages.
On failure: If font fails to load, check network access. Replace Inter with a system font fallback as a temporary workaround.
Create src/app/api/health/route.ts:
import { NextResponse } from "next/server";
export async function GET() {
return NextResponse.json({ status: "ok", timestamp: new Date().toISOString() });
}
Expected: File created at src/app/api/health/route.ts.
On failure: Ensure the api/health/ directory exists. The file must export named HTTP method handlers (GET, POST, etc.), not a default export.
cd my-app
npm run dev
Expected: Application running at http://localhost:3000.
On failure: Check Node.js version (>= 18.17). Run npm install if dependencies are missing.
npm run dev starts without errorsnpm run lint)node --version.npm run dev -- -p 3001.@/* maps to src/*. Don't confuse with node_modules imports.src/app/) not Pages Router (src/pages/).setup-tailwind-typescript - detailed Tailwind and TypeScript configurationdeploy-to-vercel - deploy the scaffolded appconfigure-git-repository - version control setupnpx claudepluginhub pjt222/agent-almanacGuides phased development of React and Next.js 14+ apps with App Router, Server Components, TypeScript, Tailwind CSS, and modern patterns. Use for new projects, component architecture, styling, and data fetching.
Implements Next.js App Router with file-system routing, root/nested layouts, templates, loading/error/not-found states, dynamic routes, and generateStaticParams for modern Next.js 13+ apps.
Guides full-stack Next.js project scaffolding with Tailwind v4, shadcn/ui, better-auth, and Vercel deployment via six interactive steps and agent teams.