App directory (App Router) in NextJS - Step-by-Step Execution

Concept Flow - App directory (App Router)

Start: User Request URL

↓

Next.js App Router reads /app directory

↓

Match URL to folder/file in /app

↓

Load Server Component for route

↓

Render Server Component to HTML

↓

Send HTML to Browser

↓

Browser hydrates Client Components

↓

User interacts -> Client Components update

↓

Next.js handles navigation with client routing

↓

Repeat for new routes

This flow shows how Next.js App Router uses the /app folder to match URLs, render server components, send HTML, and hydrate client components for interactive pages.

Execution Sample

NextJS

app/page.tsx
export default function Page() {
  return <h1>Welcome to Next.js App Router</h1>;
}

This code defines the root page component in the /app directory that renders a heading on the homepage.

Execution Table

Step	Action	Input/State	Output/Result
1	User requests '/' URL	URL: '/'	Next.js starts routing process
2	App Router reads /app directory	Folder structure: /app/page.tsx	Matches '/' to /app/page.tsx
3	Load Server Component 'Page'	Component code loaded	Component ready to render
4	Render Server Component to HTML	JSX: <h1>Welcome to Next.js App Router</h1>	HTML: <h1>Welcome to Next.js App Router</h1>
5	Send HTML to browser	HTML sent	Browser receives static HTML
6	Browser hydrates Client Components	Hydration scripts run	Page becomes interactive
7	User clicks link to '/about'	Navigation event	Next.js intercepts and loads /app/about/page.tsx
8	Repeat render and hydration for new route	New component loaded	New page rendered without full reload
9	Exit	No more navigation	Page stays interactive

💡 User stops navigation or closes page, ending routing cycle

Variable Tracker

Variable	Start	After Step 3	After Step 4	After Step 6	After Step 8	Final
URL	/	/	/	/	/about	/about
Component Loaded	None	Page (root)	Page (root)	Page (root)	About Page	About Page
HTML Output	None	None	<h1>Welcome to Next.js App Router</h1>	<h1>Welcome to Next.js App Router</h1>	<h1>About Page</h1>	<h1>About Page</h1>
Hydration State	Not hydrated	Not hydrated	Not hydrated	Hydrated	Hydrated	Hydrated

Key Moments - 3 Insights

Why does Next.js render the page on the server first before sending HTML to the browser?

Next.js renders on the server to send fully formed HTML quickly, improving load speed and SEO, as shown in execution_table step 4 and 5.

What happens during hydration in the browser?

Hydration attaches JavaScript to the static HTML so the page becomes interactive, as seen in execution_table step 6.

How does Next.js handle navigation without full page reloads?

Next.js intercepts link clicks and loads new components client-side, updating the page smoothly, demonstrated in steps 7 and 8.

Visual Quiz - 3 Questions

Look at the execution_table, what HTML is sent to the browser at step 5?

A <div>Loading...</div>

B <h1>About Page</h1>

C <h1>Welcome to Next.js App Router</h1>

D No HTML sent yet

💡 Hint

Check the Output/Result column at step 5 in execution_table

At which step does the browser make the page interactive by running JavaScript?

A Step 4

B Step 6

C Step 2

D Step 8

💡 Hint

Look for hydration in the Action column in execution_table

If the user navigates to '/about', which variable changes in variable_tracker after step 8?

A URL changes to '/about'

B Component Loaded stays 'Page (root)'

C HTML Output remains the same as root page

D Hydration State becomes 'Not hydrated' at step 6

💡 Hint

Check the URL and Component Loaded rows after step 8 in variable_tracker

Concept Snapshot

Next.js App Router uses the /app directory to map URLs to React Server Components.
Server Components render HTML on the server and send it to the browser.
The browser hydrates components to add interactivity.
Client-side navigation loads new components without full reload.
This improves performance and user experience.

Full Transcript

The Next.js App Router uses the /app directory to organize routes. When a user requests a URL, Next.js matches it to a folder or file inside /app. It loads the corresponding React Server Component and renders it to HTML on the server. This HTML is sent to the browser quickly for fast page loads and SEO benefits. Then, the browser runs hydration scripts to make the page interactive. When the user navigates to another route, Next.js intercepts the navigation and loads the new component client-side, updating the page without a full reload. This process repeats for each route, providing a smooth and fast user experience.