CLI create-next-app
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 Router |
--api | Инициализировать проект только с обработчиками маршрутов |
--src-dir | Инициализировать внутри директории src/ |
--turbopack | Включить 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 Router? (рекомендуется) Нет / Да
Использовать Turbopack для `next dev`? Нет / Да
Настроить псевдоним импорта (`@/*` по умолчанию)? Нет / ДаПосле ответов на вопросы будет создан новый проект с выбранной конфигурацией.
С официальным примером Next.js
Чтобы создать новое приложение, используя официальный пример Next.js, используйте флаг --example. Например:
npx create-next-app@latest --example [example-name] [your-project-name]Список всех доступных примеров вместе с инструкциями по настройке можно найти в репозитории Next.js.
С любым публичным примером из GitHub
Чтобы создать новое приложение, используя любой публичный пример из GitHub, используйте опцию --example с URL репозитория GitHub. Например:
npx create-next-app@latest --example "https://github.com/.../" [your-project-name]