AVAILABLE FOR WEB, FLUTTER & QA PROJECTS

How to use this tool

1. Select App Template Preset

Choose SaaS Dashboard, Marketing & Blog, E-Commerce Store, or start with a custom architecture.

2. Toggle Advanced Routing Features

Enable Route Groups (group), Parallel Routes (@modal/@analytics), Dynamic Segments [slug], and Catch-all [...path].

3. Include Standard Special Files

Select layout.tsx, loading.tsx, error.tsx, not-found.tsx, and route.ts API endpoints.

4. Copy Directory Tree & Scaffold Commands

Copy the formatted ASCII folder tree or one-line bash mkdir/touch scaffolding commands.

Formula or logic used

Next.js 15 App Router Directory Conventions

Next.js App Router relies on folder-based filesystem routing where only folders containing a page.tsx or route.ts file become publicly accessible URLs.

  • Route Groups: Folders named `(groupName)` organize code without affecting URL path structure
  • Dynamic Segments: Folders named `[slug]` match single parameters; `[...slug]` matches catch-all path segments
  • Parallel Routes: Folders named `@slotName` pass simultaneous independent sub-pages into the parent `layout.tsx`
  • Special File Hierarchy: `layout.tsx` (wraps children) > `template.tsx` (re-renders on nav) > `error.tsx` (boundary) > `loading.tsx` (Suspense) > `page.tsx`

Examples

Example 1: B2B SaaS Portal with Authentication Route Group

Input: App Router with (auth) and (dashboard) groups, settings, and parallel modal.
Calculated Result: app/(auth)/login/page.tsx, app/(dashboard)/layout.tsx, app/(dashboard)/@modal/page.tsx

Keeps auth and dashboard styling separate with isolated root layout structures.

Example 2: E-Commerce Storefront with Dynamic Products

Input: Products catalog with [category]/[id] and cart API route.
Calculated Result: app/products/[category]/[id]/page.tsx, app/api/cart/route.ts

Clean nested dynamic parameters with server-side metadata generation.

Common use cases

App Router Architecture Design

Plan clean, scalable folder structures before writing code on greenfield Next.js projects.

Pages Router to App Router Migration

Map legacy pages/ directory structures to modern app/ nested layouts and route groups.

Parallel & Intercepting Modals

Design URL-driven modals (like Twitter photo feeds or login popups) using @modal slots.

Scaffolding Automation

Generate shell scripts to create folders, page.tsx, and layout.tsx files automatically.

Web Developer Tools

Next.js Middleware Matcher Tester

The Next.js Middleware Matcher Tester validates Next.js middleware config.matcher regular expressions and glob...

Launch Tool →
Web Developer Tools

Next.js Metadata Generator

The Next.js Metadata Generator creates production-grade, type-safe Next.js App Router metadata configurations,...

Launch Tool →
Web Developer Tools

Next.js Sitemap Generator

The Next.js Sitemap Generator constructs idiomatic `app/sitemap.ts` code for the Next.js App Router, combining...

Launch Tool →

Frequently asked questions

What is the purpose of route groups (folderName) in Next.js?

Route groups (surrounded by parentheses) allow you to organize folders without creating URL path segments. They are commonly used to apply distinct layout wrappers to different sections (e.g. (marketing) vs (dashboard)).

What is the difference between layout.tsx and template.tsx?

A layout persists across route transitions and maintains its state without re-rendering. A template creates a fresh component instance on every navigation, resetting state and triggering enter animations.

How do Parallel Routes work in Next.js?

Parallel routes (named `@slot`) allow you to render multiple pages simultaneously inside the same layout (e.g. `@dashboard` and `@analytics`). The parent layout receives both slots as props.

Can an App Router folder contain both page.tsx and route.ts?

No. A folder cannot have both page.tsx and route.ts at the exact same path level because Next.js cannot resolve whether to return an HTML document or an API JSON response.

Blueprint Grid Background
AVAILABLE FOR NEW CONTRACTS & ARCHITECTURAL BUILDS

Let's build something
exceptional together

Work directly with Faisal Rafique to architect and deliver high-performance Next.js 15 platforms, 60fps Flutter mobile applications, and enterprise automated QA testing pipelines.

Direct Senior Architect Access
100% Code & IP Ownership
Milestone-Based Global Delivery