Use client directive in NextJS

Introduction

The use client directive tells Next.js that a component should run in the browser, not on the server. This helps Next.js know where to render your code.

When you want to use React hooks like <code>useState</code> or <code>useEffect</code> that only work in the browser.

When your component needs to respond to user actions like clicks or typing.

When you want to access browser-only APIs like <code>window</code> or <code>localStorage</code>.

When you want to add animations or interactive UI elements that need client-side rendering.

Syntax

NextJS

"use client";

export default function MyComponent() {
  // component code here
}

The directive must be the very first line in your component file.

It is a plain string, not a function or import.

Examples

This component uses useState to track clicks, so it needs the use client directive.

NextJS

"use client";

import { useState } from 'react';

export default function Counter() {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount(count + 1)}>
      Count: {count}
    </button>
  );
}

A simple client component that renders a greeting message.

NextJS

"use client";

export default function Greeting() {
  return <h1>Hello from the client!</h1>;
}

Sample Program

This component shows a button that toggles between ON and OFF states when clicked. It uses useState, so it must run on the client. The aria-pressed attribute helps screen readers understand the toggle state.

NextJS

"use client";

import { useState } from 'react';

export default function Toggle() {
  const [isOn, setIsOn] = useState(false);

  return (
    <button onClick={() => setIsOn(!isOn)} aria-pressed={isOn}>
      {isOn ? 'ON' : 'OFF'}
    </button>
  );
}

Important Notes

Without use client, React hooks like useState will cause errors because they only work in the browser.

Server components are faster but cannot handle user interactions directly.

Use use client only when needed to keep your app fast and efficient.

Summary

Use the use client directive to mark components that need to run in the browser.

Place it as the first line in your component file.

Use it when your component uses React hooks or browser APIs.

Practice

1. What is the main purpose of the use client directive in Next.js?

easy

A. To enable server-side rendering for a component

B. To define API routes in Next.js

C. To import CSS styles globally

D. To mark a component to run only in the browser

Solution

1. Step 1: Understand the role of use client

   The directive tells Next.js that the component should run on the client side (browser) instead of the server.

2. Step 2: Identify when to use it

   It is used when components use React hooks or browser-specific APIs that require client-side execution.

3. Final Answer:

   To mark a component to run only in the browser -> Option D

4. Quick Check:

   Client directive = run in browser [OK]

Hint: Remember: use client means browser-only code [OK]

Common Mistakes:

• Thinking it enables server-side rendering
• Using it to import styles
• Confusing it with API route setup

2. Where should the use client directive be placed in a Next.js component file?

easy

A. At the very top, before any imports or code

B. After all imports but before the component function

C. Inside the component function body

D. At the bottom of the file

Solution

1. Step 1: Recall the directive placement rule

   The use client directive must be the first line in the file to be recognized properly.

2. Step 2: Understand why placement matters

   Placing it first ensures Next.js treats the entire file as a client component before processing imports or code.

3. Final Answer:

   At the very top, before any imports or code -> Option A

4. Quick Check:

   Directive first line = correct placement [OK]

Hint: Always put use client as the first line [OK]

Common Mistakes:

• Placing it inside the component function
• Putting it after imports
• Adding it at the file end

3. Given this Next.js component code, what will happen when it is rendered?

"use client";
import { useState } from 'react';

export default function Counter() {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount(count + 1)}>Clicked {count} times</button>
  );
}

medium

A. The button will display and increment the count on clicks

B. The component will throw a syntax error due to missing quotes

C. The count will not update because use client is missing

D. The component will render but the button won't respond to clicks

Solution

1. Step 1: Check for use client directive

   The directive is present as the first line, so this is a client component that can use hooks.

2. Step 2: Analyze the useState hook usage

   The useState hook manages the count state, and the button updates it on click, so the count increments correctly.

3. Final Answer:

   The button will display and increment the count on clicks -> Option A

4. Quick Check:

   Client directive + useState = interactive button [OK]

Hint: If use client is present, hooks work normally [OK]

Common Mistakes:

• Assuming missing quotes cause syntax error
• Thinking use client is missing
• Believing button won't update state

4. Identify the error in this Next.js component:

import { useState } from 'react';

export default function Clicker() {
  const [count, setCount] = useState(0);
  return (
    <button onClick={() => setCount(count + 1)}>Clicked {count} times</button>
  );
}

medium

A. Invalid JSX syntax in the return statement

B. Missing use client directive at the top

C. Incorrect import statement for useState

D. State variable count is not initialized

Solution

1. Step 1: Check for use client directive

   The component uses useState hook but lacks the use client directive, which is required for client-side hooks.

2. Step 2: Verify other code parts

   Imports and JSX syntax are correct, and the state variable is initialized properly.

3. Final Answer:

   Missing use client directive at the top -> Option B

4. Quick Check:

   Hooks need use client directive [OK]

Hint: Hooks require use client directive to work [OK]

Common Mistakes:

• Ignoring the missing directive
• Thinking import is wrong
• Assuming JSX syntax error

5. You want to create a Next.js component that uses useState and also fetches data from an API on the client side using useEffect. Which is the correct way to set up this component?

hard

A. "use server"; import { useState, useEffect } from 'react'; export default function DataFetcher() { const [data, setData] = useState(null); useEffect(() => { fetch('/api/data').then(res => res.json()).then(setData); }, []); return {data ? JSON.stringify(data) : 'Loading...'}; }

B. import { useState, useEffect } from 'react'; export default function DataFetcher() { const [data, setData] = useState(null); useEffect(() => { fetch('/api/data').then(res => res.json()).then(setData); }, []); return {data ? JSON.stringify(data) : 'Loading...'}; }

C. "use client"; import { useState, useEffect } from 'react'; export default function DataFetcher() { const [data, setData] = useState(null); useEffect(() => { fetch('/api/data').then(res => res.json()).then(setData); }, []); return {data ? JSON.stringify(data) : 'Loading...'}; }

D. "use client"; import { useState } from 'react'; export default function DataFetcher() { const [data, setData] = useState(null); fetch('/api/data').then(res => res.json()).then(setData); return {data ? JSON.stringify(data) : 'Loading...'}; }

Solution

1. Step 1: Confirm client directive usage

   Since the component uses hooks (useState, useEffect) and browser APIs, it must start with "use client";.

2. Step 2: Check correct hook usage for data fetching

   Data fetching should be inside useEffect to run after render, avoiding side effects during rendering.

3. Step 3: Identify the correct option

   "use client"; import { useState, useEffect } from 'react'; export default function DataFetcher() { const [data, setData] = useState(null); useEffect(() => { fetch('/api/data').then(res => res.json()).then(setData); }, []); return
   {data ? JSON.stringify(data) : 'Loading...'}; } correctly includes the directive, imports both hooks, and uses useEffect for fetching data.

4. Final Answer:

   "use client"; with useState, useEffect, and fetch inside useEffect -> Option C

5. Quick Check:

   Client directive + useEffect fetch = correct pattern [OK]

Hint: Use "use client" and fetch inside useEffect [OK]

Common Mistakes:

• Omitting use client directive
• Fetching data outside useEffect
• Using "use server" directive incorrectly