Next.js: от React-приложения к fullstack framework
В этом курсе мы выходим на уровень fullstack-разработки на TypeScript. Вы уже умеете создавать приложения на React и TypeScript, работать с компонентами, состоянием, маршрутизацией, HTTP и API.
Теперь задача меняется.
Нам нужен не только интерфейс в браузере, но приложение, которое умеет выполнять часть работы на сервере:
- получать данные до отправки страницы пользователю;
- обращаться к защищённым источникам данных;
- формировать маршруты без ручной настройки router;
- выполнять серверные операции;
- отдавать HTTP endpoints;
- управлять loading и error states;
- собираться и запускаться как единое fullstack-приложение.
Для этого мы будем использовать Next.js.
Главная идея урока:
Next.js не заменяет React. React отвечает за модель пользовательского интерфейса, а Next.js добавляет framework-уровень: маршрутизацию, серверное выполнение, загрузку данных, HTTP-возможности и соглашения для построения полноценного web-приложения.
React и framework решают разные задачи
React позволяет описывать UI через компоненты:
type Task = {
id: string;
title: string;
};
export function TaskCard({
task,
}: {
task: Task;
}) {
return (
<article>
<h2>{task.title}</h2>
</article>
);
}
React хорошо отвечает на вопросы:
- как разбить интерфейс на компоненты;
- как передавать props;
- как хранить локальное состояние;
- как реагировать на события;
- как обновлять UI при изменении данных.
Но полноценному приложению нужно значительно больше.
Например:
/tasks
/tasks/new
/tasks/task-42
/tasks/task-42/edit
Нужно определить:
- какой URL соответствует какой странице;
- где загружать данные;
- какой код должен выполняться на сервере;
- какой код нужен браузеру;
- что показать во время загрузки;
- как обработать отсутствующий ресурс;
- как вернуть HTTP-response;
- как подготовить production build.
В обычном React SPA эти задачи собираются из отдельных решений:
React
+ router
+ data fetching
+ build tool
+ backend API
+ deployment configuration
Это нормальная архитектура. Next.js предлагает другую модель:
React
↓
Next.js
├── routing
├── server rendering
├── server data loading
├── client interactivity
├── HTTP endpoints
└── production conventions
Поэтому Next.js правильнее воспринимать не как «улучшенную версию React», а как framework вокруг React. React остаётся внутри.
Почему одного client-side rendering бывает недостаточно
Классическое SPA часто стартует с небольшого HTML:
<!doctype html>
<html lang="ru">
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
После загрузки JavaScript React создаёт интерфейс в браузере.
Упрощённо:
Browser
↓
HTML
↓
JavaScript
↓
React
↓
API requests
↓
UI
Такой подход называется client-side rendering (CSR). Для множества продуктов он полностью подходит (например, внутренний dashboard после входа пользователя может прекрасно работать как SPA).
Но теперь представим публичную страницу:
/products/nextjs-course
Для неё могут быть важны:
- первоначальный HTML с содержимым;
- metadata;
- быстрый первый показ;
- загрузка данных на сервере;
- отсутствие необходимости отдавать browser часть серверных credentials.
Или страница приложения должна получить данные напрямую из PostgreSQL. Плохая идея:
Browser
↓
PostgreSQL (Database credentials нельзя отдавать клиенту!)
Нужна надёжная серверная граница:
Browser
↓
Next.js server
↓
PostgreSQL
Next.js позволяет React-приложению естественно работать и на клиентской, и на серверной стороне. Это не означает, что всё нужно рендерить на сервере или что CSR больше не нужен.
Современное приложение часто является гибридным:
- server → данные и первоначальная структура
- client → интерактивность
Именно эту границу мы будем изучать на протяжении всего курса.
App Router превращает файловую структуру в маршруты
В обычном SPA маршрут часто объявляется программно:
/tasks
→ TasksPage
/tasks/new
→ NewTaskPage
/tasks/:taskId
→ TaskPage
В Next.js App Router структура маршрутов задаётся каталогами. Например:
app/
├── page.tsx
└── tasks/
├── page.tsx
├── new/
│ └── page.tsx
└── [taskId]/
├── page.tsx
└── edit/
└── page.tsx
Из неё получаются маршруты:
Каталог [taskId] обозначает динамический segment. Поэтому один маршрут /tasks/[taskId] может обслуживать /tasks/task-1, /tasks/task-42, /tasks/task-900.
URL становится частью структуры приложения, а routing — framework convention.
Server Components и Client Components разделяют ответственность
Одна из ключевых идей App Router — React-компонент необязательно должен выполняться в браузере. По умолчанию компоненты в App Router являются Server Components.
Например страница списка:
export default async function TasksPage() {
const tasks = await getTasks();
return (
<main>
<h1>Tasks</h1>
<ul>
{tasks.map((task) => (
<li key={task.id}>
{task.title}
</li>
))}
</ul>
</main>
);
}
Здесь компонент может получить данные непосредственно в серверной части приложения. Нам не обязательно строить классическую цепочку render empty component → useEffect → fetch → loading state → setState → second render.
Для серверной страницы возможно: request → load data on server → render → response.
Но Server Component не заменяет клиентскую интерактивность. Представим поиск, который пользователь меняет прямо в интерфейсе:
'use client';
import { useState } from 'react';
export function TaskSearch() {
const [query, setQuery] = useState('');
return (
<label>
Поиск
<input
value={query}
onChange={(event) => {
setQuery(event.target.value);
}}
/>
</label>
);
}
Здесь нужен useState, onChange и браузерные события, поэтому это Client Component.
Получается важная граница:
- Server Component → server data, server-only dependencies, первоначальный UI
- Client Component → events, local state, browser APIs, интерактивность
Какая часть конкретного пользовательского сценария действительно должна выполняться в браузере?
По умолчанию сохраняйте серверную часть серверной и добавляйте'use client'только там, где появляется реальная интерактивная необходимость.
Когда Next.js оправдан
Next.js подходит не потому, что «сейчас модно писать на Next.js». Framework должен решать реальные задачи продукта.
Рассмотрим три приложения:
- Внутренний dashboard: Пользователь всегда авторизован, SEO не требуется, интерфейс очень интерактивный. Такой продукт вполне может оставаться обычным React SPA.
- Публичный каталог: Есть страницы продуктов, metadata, публичные URL, server data и требования к первоначальной загрузке. Next.js здесь даёт максимальные преимущества.
- SaaS-приложение: Есть публичный landing, authentication, dashboard, database, server mutations, API, metadata, account settings. Это эталонный пример гибридного приложения, где framework позволяет держать публичные, серверные и интерактивные части в единой архитектуре.
Дальше мы постепенно пройдём путь:
React UI
↓
Next.js routing
↓
Server Components
↓
server data
↓
mutations
↓
HTTP
↓
PostgreSQL
↓
authentication
↓
production SaaS
Next.js здесь — не конечная цель, а framework foundation, поверх которого мы будем строить весь дальнейший fullstack stack.
Практическое задание
Создайте первое Next.js-приложение на TypeScript с App Router.
Задание 1. Структура маршрутов
Приложение должно поддерживать:
/— главная страница/tasks— список задач/tasks/new— форма создания/tasks/[taskId]— просмотр конкретной задачи/tasks/[taskId]/edit— редактирование задачи
Задание 2. Серверная страница списка
Создайте серверную страницу app/tasks/page.tsx, получающую данные напрямую через асинхронную функцию getTasks() без использования useEffect.
Задание 3. Изоляция интерактивности (Client Boundary)
Вынесите интерактивную строку поиска TaskSearch в отдельный клиентский компонент с директивой 'use client', сохранив родительскую страницу TasksPage серверной.
Задание 4. Сравнение архитектур
Сравните обязанности и возможности классического React SPA и Next.js App Router (роутинг, загрузка данных, серверный код, интерактивность, API).
Как точнее всего описать отношение Next.js и React?
Какие возможности Next.js добавляет поверх React?
Что означает CSR?
Какой маршрут создаёт файл app/tasks/page.tsx?
Что означает каталог [taskId]?
Какие задачи естественно выполнять в Server Component?
Когда нужен Client Component?
Нужно ли превращать всю страницу в Client Component, если один input использует useState?
Какие приложения могут получить особенно заметную пользу от Next.js?
Какой принцип лучше использовать при разделении server/client responsibility?
Серверная страница и клиентская граница в Next.js
Реализуйте серверную страницу TasksPage с загрузкой данных и изолированный клиентский компонент TaskSearch с поисковым input.
Ваш прогресс в уроке
Выполняйте задания, чтобы заработать все баллы
