Lesson 14/100

Tutorials Next.js Tutorial

CSS Modules — Complete Guide

CSS Modules — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of Next.js Tutorial on Toolliyo Academy.

On this page

Next.js Tutorial (LearnHub) · Lesson 14 of 100

CSS Modules

BeginnerIntermediateAdvancedProfessional

Beginner · 1 — Foundations · ~12 min read · Module 2: Layouts & Styling

Introduction

This lesson is part of the beginner section. We explain CSS Modules slowly, with examples you can copy and run. If something is unclear, read it twice — that is how everyone learns. CSS Modules scope styles to one component. file.module.css exports class names that are unique at build time — no global clashes between CourseCard and LessonList. LearnHub has dozens of components. Global CSS alone makes .title accidentally style every heading on the site.

CSS Modules appears in almost every LearnHub page you will build. Once it clicks, data fetching and auth become much easier.

When will you use this?

You use layouts and styling in every page you build from your first screen to production.

  • Course catalogs, lesson sidebars, and instructor dashboards all use layouts and shared navigation.
  • When a student opens a lesson page, nested layouts keep the header and progress bar consistent.

Real-world: Flipkart-style catalog

The E-commerce team building Flipkart-style catalog uses CSS Modules to style course cards without class name clashes across pages. shoppers never see the TypeScript files — they just get a fast, reliable search, filters, and fast product listing pages.

Production-style code

/* components/CourseCard.module.css */
.card {
  border: 1px solid #e2e8f0;
  border-radius: 8px;
  padding: 1rem;
}
.title {
  font-size: 1.125rem;
  font-weight: 600;
}

// components/CourseCard.tsx
import styles from './CourseCard.module.css';

export function CourseCard({ title }: { title: string }) {
  return (
    <article className={styles.card}>
      <h2 className={styles.title}>{title}</h2>
    </article>
  );
}

What happens in production: In Flipkart-style catalog, getting CSS Modules right means shoppers trust the search, filters, and fast product listing pages every day.

Lesson example (start here)

Copy this smaller example first. Once it works, compare it with the real-world code above.

/* components/CourseCard.module.css */
.card {
  border: 1px solid #e2e8f0;
  border-radius: 8px;
  padding: 1rem;
}
.title {
  font-size: 1.125rem;
  font-weight: 600;
}

// components/CourseCard.tsx
import styles from './CourseCard.module.css';

export function CourseCard({ title }: { title: string }) {
  return (
    <article className={styles.card}>
      <h2 className={styles.title}>{title}</h2>
    </article>
  );
}

Line-by-line walkthrough

CodeWhat it means
/* components/CourseCard.module.css */Part of the CSS Modules example — read it together with the lines before and after.
.card {Part of the CSS Modules example — read it together with the lines before and after.
border: 1px solid #e2e8f0;Part of the CSS Modules example — read it together with the lines before and after.
border-radius: 8px;Part of the CSS Modules example — read it together with the lines before and after.
padding: 1rem;Part of the CSS Modules example — read it together with the lines before and after.
}Closes a block started by { above.
.title {Part of the CSS Modules example — read it together with the lines before and after.
font-size: 1.125rem;Part of the CSS Modules example — read it together with the lines before and after.
font-weight: 600;Part of the CSS Modules example — read it together with the lines before and after.
}Closes a block started by { above.
// components/CourseCard.tsxComment — notes for humans; the compiler ignores it.
import styles from './CourseCard.module.css';Imports a module so you can use its exports in this file.
export function CourseCard({ title }: { title: string }) {Named export — reusable function or component.
return (Returns JSX — what the user sees in the browser.

How it works (big picture)

  • Import styles object and use styles.card.
  • Build tool hashes class names.
  • Combine with global globals.css for resets and fonts.

Do this on your computer

  1. Create CourseCard.module.css
  2. Import styles in CourseCard.tsx
  3. Add a second module for LessonRow — confirm no style bleed
  4. Use composes or multiple classes if needed
  5. Read the real-world section and name which part of LearnHub uses this topic.
  6. Run the example locally with npm run dev and confirm the same behavior.
  7. Change one value in the example (route, text, or course id) and predict what will happen before you save.

Experiments — try changing this

  • Change a string or route in the example and save — watch the browser update.
  • Break the code on purpose (remove a bracket), read the error overlay, then fix it.

Remember

*.module.css = scoped classes. Import as styles object. Pair with globals.css for site-wide base.

Common questions

CSS Modules vs Tailwind?

LearnHub uses both — Tailwind for layout utilities, modules for complex component-specific rules if needed.

How long should I spend on CSS Modules?

Until you can explain it in your own words and run the example without looking at the answer. Beginners often need 30–60 minutes per new concept; setup lessons may take one afternoon.

What if I get stuck on CSS Modules?

Re-read the line-by-line walkthrough, check the terminal and browser overlay for errors, and compare your code character-by-character with the example. Search the exact error text — someone else had it too.

Where is CSS Modules used in real jobs?

See the real-world section above — the same pattern appears in LMS, e-commerce, SaaS, and dashboards. Interviewers ask you to explain it using one concrete example.

Interview prep for this lesson

Practice these questions aloud after reading—each links to a full structured answer.

Junior Detailed
Explain JavaScript in the context of Next.js.
Short answer: JavaScript runs single-threaded with an event loop. Closures capture lexical scope; promises/async handle I/O without blocking the UI thread. Real-world example (ShopNest) On the ShopNest storefront UI, thi…
Mid Detailed
What are common mistakes teams make with Components when using Next.js?
Short answer: Interviewers want a crisp definition, a practical example from your projects, and awareness of trade-offs—not textbook dumps. Explain a bit more How to structure your answer (60–90 seconds) Define Component…
Senior Detailed
How would you debug a production issue related to State in a Next.js application?
Short answer: Interviewers want a crisp definition, a practical example from your projects, and awareness of trade-offs—not textbook dumps. Explain a bit more How to structure your answer (60–90 seconds) Define State in…
Junior Detailed
Describe a real-world scenario where Performance mattered in a Next.js project.
Short answer: Interviewers want a crisp definition, a practical example from your projects, and awareness of trade-offs—not textbook dumps. Explain a bit more How to structure your answer (60–90 seconds) Define Performan…
Questions on this lesson 0

Sign in to ask a question or upvote helpful answers.

No questions yet — be the first to ask!

Next.js Tutorial
Course syllabus

Next.js Tutorial

Start here
Module 1: Next.js Foundations
Module 2: Layouts & Styling
Module 3: Data & Forms
Module 4: Auth & APIs
Module 5: SEO & Deploy
Module 6: Advanced Routing
Module 7: Auth & Database
Module 8: Quality & Security
Module 9: Cloud & Scale
Module 10: Portfolio Projects
Toolliyo Assistant
Ask about tutorials, ebooks, training, pricing, mentor services, and support. I use public site content only—not admin or internal tools.

care@toolliyo.com

Need callback? Share your details