System Architecture

Core Technologies

Next.js 15 (App Router): The backbone of the application, handling routing, SSR, and API endpoints.

Prisma ORM: Manages database access and schema definitions.

Tailwind CSS: Utility-first styling engine.

Shadcn/UI: Accessible, reusable component primitives.

NextAuth.js: Authentication and session management.

Due to Next.js 15 middleware limitations with Edge runtimes, we use a specialized proxy.ts helper for route protection.

Incoming Request: User hits /cms/dashboard.

Layout Check: The root layout calls auth().

Redirect: If no session exists, server component redirects to /login.

We typically use unstable_cache for high-frequency reads:

Tags: We assign cache tags like ['site-config'] or ['blog-posts'].

Revalidation: On mutation (e.g., updating a post), we call revalidateTag('blog-posts') to purge the cache.