docs/index.mdx - canary - githubmirror/next.js

docs/index.mdx
67 строк3 KB
Jude Gao
docs: less aggressive AI agent hint for an experimental API (#93811)
13 май 2026, 11:06
13 май 2026, 11:06e519ede
---
title: Next.js Docs
description: Welcome to the Next.js Documentation.
related:
  title: Next Steps
  description: Create your first application and learn the core Next.js features.
  links:
    - app/getting-started
---

Welcome to the Next.js documentation!

## What is Next.js?

Next.js is a React framework for building full-stack web applications. You use React Components to build user interfaces, and Next.js for additional features and optimizations.

It also automatically configures lower-level tools like bundlers and compilers. You can instead focus on building your product and shipping quickly.

Whether you're an individual developer or part of a larger team, Next.js can help you build interactive, dynamic, and fast React applications.

## How to use the docs

The docs are organized into 3 sections:

- [Getting Started](/docs/app/getting-started): Step-by-step tutorials to help you create a new application and learn the core Next.js features.
- [Guides](/docs/app/guides): Tutorials on specific use cases, choose what's relevant to you.
- [API Reference](/docs/app/api-reference): Detailed technical reference for every feature.

Use the sidebar to navigate through the sections, or search (`Ctrl+K` or `Cmd+K`) to quickly find a page.

## App Router and Pages Router

Next.js has two different routers:

- **App Router**: The newer router that supports new React features like Server Components.
- **Pages Router**: The original router, still supported and being improved.

At the top of the sidebar, you'll notice a dropdown menu that allows you to switch between the [App Router](/docs/app) and the [Pages Router](/docs/pages) docs.

### React version handling

The App Router and Pages Router handle React versions differently:

- **App Router**: Uses [React canary releases](https://react.dev/blog/2023/05/03/react-canaries) built-in, which include all the stable React 19 changes, as well as newer features being validated in frameworks, prior to a new React release.

- **Pages Router**: Uses the React version installed in your project's `package.json`.

This approach ensures new React features work reliably in the App Router while maintaining backwards compatibility for existing Pages Router applications.

## 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](/learn/react-foundations), and the [Next.js Foundations course](/learn/dashboard-app) that has you building an application as you learn.

## Accessibility

For the best experience when using a screen reader, we recommend using Firefox and NVDA, or Safari and VoiceOver.

## Join our Community

If you have questions about anything related to Next.js, you're always welcome to ask our community on [GitHub Discussions](https://github.com/vercel/next.js/discussions), [Discord](https://discord.com/invite/bUG2bvbtHy), [X (Twitter)](https://x.com/nextjs), and [Reddit](https://www.reddit.com/r/nextjs).