Next.js Tutorial
Lesson 4/101

Tutorials Next.js Tutorial

Understanding Project Structure — Complete Guide

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

8 min read Updated 6/25/2026
On this page

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

Understanding Project Structure

Beginner → Intermediate → Advanced → Professional

Beginner · 1 — Foundations · ~12 min read · Module 1: Next.js Foundations

Introduction

This lesson is part of the beginner section. We explain Understanding Project Structure slowly, with examples you can copy and run. If something is unclear, read it twice — that is how everyone learns. A new App Router project includes app/ (routes and layouts), public/ (static files), next.config.ts (framework config), package.json (scripts and deps), and tsconfig.json (TypeScript). Optional src/app/ if you chose src directory. When a teammate says "fix the course catalog page," you need to know app/courses/page.tsx vs components/ without guessing.

Understanding Project Structure is setup knowledge. Without it, LearnHub will not run. Spend time here until npm run dev works without errors.

When will you use this?

You need this before writing any Next.js code — same as installing Node.js before opening a project.

  • Every React/Next.js job expects you to run npx create-next-app and npm run dev on day one.
  • Interviewers often ask you to explain the App Router folder structure and Server vs Client Components.

Real-world: Zoho-style SaaS dashboard

The B2B SaaS team building Zoho-style SaaS dashboard uses Understanding Project Structure to know which folder to edit when fixing the course catalog or lesson page. tenant admins never see the TypeScript files — they just get a fast, reliable billing, team settings, and analytics widgets.

Production-style code

learnhub/
  app/
    layout.tsx      → root shell (html, body, fonts)
    page.tsx        → home route /
    globals.css     → global styles
  public/
    logo.svg        → static URL /logo.svg
  components/       → you add reusable UI here
  next.config.ts
  package.json

What happens in production: In Zoho-style SaaS dashboard, a solid Understanding Project Structure foundation lets the team ship billing, team settings, and analytics widgets on schedule without toolchain surprises.

Lesson example (start here)

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

learnhub/
  app/
    layout.tsx      → root shell (html, body, fonts)
    page.tsx        → home route /
    globals.css     → global styles
  public/
    logo.svg        → static URL /logo.svg
  components/       → you add reusable UI here
  next.config.ts
  package.json

Line-by-line walkthrough

CodeWhat it means
learnhub/Part of the Understanding Project Structure example — read it together with the lines before and after.
app/Part of the Understanding Project Structure example — read it together with the lines before and after.
layout.tsx → root shell (html, body, fonts)Part of the Understanding Project Structure example — read it together with the lines before and after.
page.tsx → home route /Part of the Understanding Project Structure example — read it together with the lines before and after.
globals.css → global stylesPart of the Understanding Project Structure example — read it together with the lines before and after.
public/Part of the Understanding Project Structure example — read it together with the lines before and after.
logo.svg → static URL /logo.svgPart of the Understanding Project Structure example — read it together with the lines before and after.
components/ → you add reusable UI herePart of the Understanding Project Structure example — read it together with the lines before and after.
next.config.tsPart of the Understanding Project Structure example — read it together with the lines before and after.
package.jsonPart of the Understanding Project Structure example — read it together with the lines before and after.

How it works (big picture)

  • layout.tsx wraps every page.
  • page.tsx maps to a URL segment.
  • public/ files are served as-is.
  • You will add components/ and lib/ as LearnHub grows.

Do this on your computer

  1. Open each top-level folder in your editor
  2. Read app/layout.tsx and app/page.tsx
  3. Drop an image in public/ and open /filename in the browser
  4. Create an empty components/ folder for later lessons
  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

app/ = routes, layouts, and route handlers. public/ = static assets at /path. components/ and lib/ are your custom folders.

Common questions

Where do API routes go?

app/api/.../route.ts — covered in a later lesson.

What is .next/?

Build cache — add to .gitignore, never edit manually.

Next.js Tutorial
Course syllabus
Start Here Next.js Complete Beginner's Guide
Module 1: Next.js Foundations Introduction to Next.js — Complete Guide Installing Next.js — Complete Guide Understanding Project Structure — Complete Guide App Router Basics — Complete Guide Pages and Layouts — Complete Guide React Components in Next.js — Complete Guide Client Components — Complete Guide Server Components — Complete Guide Routing Fundamentals — Complete Guide Dynamic Routing — Complete Guide
Module 2: Layouts & Styling Nested Layouts — Complete Guide Navigation and Linking — Complete Guide Static Assets — Complete Guide CSS Modules — Complete Guide Tailwind CSS in Next.js — Complete Guide Data Fetching — Complete Guide Server Actions — Complete Guide Forms in Next.js — Complete Guide Form Validation — Complete Guide Authentication Basics — Complete Guide
Module 3: Data & Forms Middleware — Complete Guide API Route Handlers — Complete Guide Database Integration — Complete Guide File Upload — Complete Guide Image Optimization — Complete Guide Metadata and SEO — Complete Guide Performance Optimization — Complete Guide Deployment — Complete Guide E-Commerce App Project — Complete Guide SaaS Dashboard Project — Complete Guide
Module 4: Auth & APIs SSR vs SSG vs ISR — Complete Guide Streaming and Suspense — Complete Guide Loading and Error UI — Complete Guide Route Groups — Complete Guide Parallel Routes — Complete Guide Intercepting Routes — Complete Guide Edge Runtime — Complete Guide Caching in Next.js — Complete Guide Revalidating Data — Complete Guide TanStack Query in Next.js — Complete Guide
Module 5: SEO & Deploy NextAuth.js — Complete Guide Clerk Authentication — Complete Guide OAuth and Social Login — Complete Guide Protected Routes — Complete Guide Prisma ORM — Complete Guide MongoDB with Next.js — Complete Guide PostgreSQL with Next.js — Complete Guide Environment Variables — Complete Guide Unit Testing — Complete Guide Integration Testing — Complete Guide
Module 6: Advanced Routing Playwright E2E — Complete Guide CI/CD for Next.js — Complete Guide Internationalization — Complete Guide Accessibility — Complete Guide XSS and CSRF Protection — Complete Guide Security Headers — Complete Guide Rate Limiting — Complete Guide Structured Data — Complete Guide Sitemap and Robots — Complete Guide Zustand State — Complete Guide
Module 7: Auth & Database Redux Toolkit in Next.js — Complete Guide React Context Patterns — Complete Guide Monorepo with Turborepo — Complete Guide Docker for Next.js — Complete Guide Vercel Deployment — Complete Guide AWS Amplify — Complete Guide Azure Static Web Apps — Complete Guide Micro Frontends — Complete Guide Remix vs Next.js — Complete Guide Web Vitals Tuning — Complete Guide
Module 8: Quality & Security Font Optimization — Complete Guide Bundle Analysis — Complete Guide Blog Application Project — Complete Guide Student Portal Project — Complete Guide Job Portal Project — Complete Guide Hospital Portal Project — Complete Guide Food Delivery Frontend Project — Complete Guide Banking Dashboard Project — Complete Guide LMS Course Player Project — Complete Guide CRM Admin Project — Complete Guide
Module 9: Cloud & Scale Real-Time Chat Project — LearnHub Project Multi-Tenant SaaS Project — LearnHub Project Inventory Dashboard Project — LearnHub Project Travel Booking Project — LearnHub Project News Portal Project — LearnHub Project Portfolio Site Project — LearnHub Project Enterprise Architecture — LearnHub Project Clean Folder Structure — LearnHub Project API Design Patterns — LearnHub Project Error Handling Patterns — LearnHub Project
Module 10: Portfolio Projects Logging and Monitoring — LearnHub Project Stripe Payments — LearnHub Project Analytics and Observability — LearnHub Project Storybook with Next.js — LearnHub Project GraphQL with Next.js — LearnHub Project Content Security Policy — LearnHub Project Partial Prerendering — LearnHub Project Server Actions Security — LearnHub Project Production Checklist — LearnHub Project Next.js Career Roadmap — LearnHub Project
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