61f56f997c
Some checks failed
Test examples / Test Examples (20) (push) Has been cancelled
Test examples / Test Examples (22) (push) Has been cancelled
Lock Threads / action (push) Has been cancelled
Trigger Release / start (push) Has been cancelled
Stale issue handler / stale (push) Has been cancelled
Update Font Data / create-pull-request (push) Has been cancelled
build-and-deploy / deploy-target (push) Has been cancelled
build-and-deploy / build (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / build-wasm (nodejs) (push) Has been cancelled
build-and-deploy / build-wasm (web) (push) Has been cancelled
build-and-deploy / Deploy preview tarball (push) Has been cancelled
build-and-deploy / Potentially publish release (push) Has been cancelled
build-and-deploy / publish-turbopack-npm-packages (push) Has been cancelled
build-and-deploy / Deploy examples (push) Has been cancelled
build-and-deploy / thank you, build (push) Has been cancelled
build-and-deploy / Upload Turbopack Bytesize metrics to Datadog (push) Has been cancelled
Rspack Next.js development integration tests / Rspack integration tests (push) Has been cancelled
Rspack Next.js production integration tests / Rspack integration tests (push) Has been cancelled
Turbopack Next.js development integration tests / Next.js integration tests (push) Has been cancelled
Turbopack Next.js production integration tests / Next.js integration tests (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack development test manifest (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack production test manifest (push) Has been cancelled
Upload bundler test manifests to areweturboyet.com / Upload test results (push) Has been cancelled
Update React / create-pull-request (push) Has been cancelled
test-e2e-project-reset-cron / reset-test-project (push) Has been cancelled
Notify about the top 15 issues/PRs/feature requests (most reacted) in the last 90 days / run (push) Has been cancelled
68 lines
3.1 KiB
Plaintext
68 lines
3.1 KiB
Plaintext
---
|
|
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).
|