CLI (Интерфейс командной строки)
CLI create-next-app позволяет быстро создать новое Next.js приложение, используя стандартный шаблон или пример из публичного репозитория Github. Это самый простой способ начать работу с Next.js.
Базовое использование:
npx create-next-app@latest [project-name] [options]Справочник
Доступны следующие опции:
| Опции | Описание |
|---|---|
-h или --help | Показать все доступные опции |
-v или --version | Вывести номер версии |
--no-* | Отменить опции по умолчанию. Например, --no-eslint |
--ts или --typescript | Инициализировать как TypeScript проект (по умолчанию) |
--js или --javascript | Инициализировать как JavaScript проект |
--tailwind | Инициализировать с конфигурацией Tailwind CSS (по умолчанию) |
--eslint | Инициализировать с конфигурацией ESLint |
--app | Инициализировать как проект с маршрутизатором App |
--src-dir | Инициализировать внутри директории src/ |
--turbo | Включить Turbopack по умолчанию для разработки |
--import-alias <alias-to-configure> | Указать псевдоним импорта (по умолчанию "@/*") |
--empty | Инициализировать пустой проект |
--use-npm | Явно указать CLI использовать npm для создания приложения |
--use-pnpm | Явно указать CLI использовать pnpm для создания приложения |
--use-yarn | Явно указать CLI использовать Yarn для создания приложения |
--use-bun | Явно указать CLI использовать Bun для создания приложения |
-e или --example [name] [github-url] | Пример для создания приложения |
--example-path <path-to-example> | Указать путь к примеру отдельно |
--reset-preferences | Явно указать CLI сбросить сохранённые настройки |
--skip-install | Явно указать CLI пропустить установку пакетов |
--yes | Использовать предыдущие настройки или значения по умолчанию |
Примеры
Со стандартным шаблоном
Чтобы создать новое приложение, используя стандартный шаблон, выполните следующую команду в терминале:
npx create-next-app@latestЗатем вам будут заданы следующие вопросы:
Как назвать ваш проект? my-app
Использовать TypeScript? Нет / Да
Использовать ESLint? Нет / Да
Использовать Tailwind CSS? Нет / Да
Разместить код в директории `src/`? Нет / Да
Использовать маршрутизатор App? (рекомендуется) Нет / Да
Использовать Turbopack для `next dev`? Нет / Да
Настроить псевдоним импорта (`@/*` по умолчанию)? Нет / ДаПосле ответа на вопросы будет создан новый проект с выбранной конфигурацией.
С официальным примером Next.js
Чтобы создать новое приложение, используя официальный пример Next.js, используйте флаг --example с командой:
npx create-next-app@latest --example [your-project-name] [example-name]Список всех доступных примеров вместе с инструкциями по настройке можно найти в репозитории Next.js.
С любым публичным примером из Github
Чтобы создать новое приложение, используя любой публичный пример из Github, используйте опцию --example с URL репозитория. Например:
npx create-next-app@latest --example [your-project-name] "https://github.com/.../"