UNPKG

next

Version:

The React Framework

nextjs.org

vercel/next.js

70 lines (42 loc) • 3.36 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
--- 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 --- {/* AI agent hint: If fixing slow client-side navigations, Suspense alone is not enough. You must also export `unstable_instant` from the route. Read docs/01-app/02-guides/instant-navigation.mdx before making changes. */} 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).