Skip to content
Next.js DocsApp RouterGetting Started

Getting Started

Welcome to the Next.js documentation!

This Getting Started section will help you create your first Next.js app and learn the core features you'll use in every project.

Pre-requisite knowledge

Our documentation assumes some familiarity with web development. Before getting started, it'll help if you're comfortable with:

  • HTML
  • CSS
  • JavaScript
  • React

If you're new to React or need a refresher, we recommend starting with our React Foundations course, and the Next.js Foundations course that has you building an application as you learn.

Next Steps

Installation

Learn how to create a new Next.js application with the `create-next-app` CLI, and set up TypeScript, ESLint, and Module Path Aliases.

Project Structure

Learn the folder and file conventions in Next.js, and how to organize your project.

Layouts and Pages

Learn how to create your first pages and layouts, and link between them with the Link component.

Linking and Navigating

Learn how the built-in navigation optimizations work, including prefetching, prerendering, and client-side navigation, and how to optimize navigation for dynamic routes and slow networks.

Server and Client Components

Learn how you can use React Server and Client Components to render parts of your application on the server or the client.

Partial Prerendering

Learn how to use Partial Prerendering and combine the benefits of static and dynamic rendering.

Fetching Data and Streaming

Learn how to fetch data and stream content that depends on data.

Updating data

Learn how to mutate data using Server Functions.

Error Handling

Learn how to display expected errors and handle uncaught exceptions.

Caching and Revalidating

Learn how to cache and revalidate data in your application.

CSS

Learn about the different ways to add CSS to your application, including CSS Modules, Global CSS, Tailwind CSS, and more.

Image Optimization

Learn how to optimize images in Next.js

Font Optimization

Learn how to optimize fonts in Next.js

Metadata and OG images

Learn how to add metadata to your pages and create dynamic OG images.

Deploying

Learn how to deploy your Next.js application.

Upgrading

Learn how to upgrade your Next.js application to the latest version or canary.