コンテンツをスキップ
API リファレンスCLIcreate-next-app CLI

create-next-app CLI

create-next-app CLI を使用すると、デフォルトのテンプレート、または公開 GitHub リポジトリから例を使用して新しい Next.js アプリケーションを作成できます。これは Next.js を始める最も簡単な方法です。

基本的な使用方法

ターミナル
npx create-next-app@latest [project-name] [options]

リファレンス

以下のオプションが利用可能です。

オプション説明
-h または --help利用可能なすべてのオプションを表示
-v または --versionバージョン番号を出力
--no-*デフォルトオプションを無効にする。例: --no-eslint
--ts または --typescriptTypeScript プロジェクトとして初期化 (デフォルト)
--js または --javascriptJavaScript プロジェクトとして初期化
--tailwindTailwind CSS 設定で初期化 (デフォルト)
--eslintESLint 設定で初期化
--appApp Router プロジェクトとして初期化
--apiルートハンドラーのみを持つプロジェクトを初期化
--src-dirsrc/ ディレクトリ内に初期化
--turbopack開発用に Turbopack をデフォルトで有効にする
--import-alias <alias-to-configure>使用するインポートエイリアスを指定 (デフォルト "@/*")
--empty空のプロジェクトを初期化
--use-npmnpm を使用してアプリケーションをブートストラップするよう CLI に明示的に指示
--use-pnpmpnpm を使用してアプリケーションをブートストラップするよう CLI に明示的に指示
--use-yarnYarn を使用してアプリケーションをブートストラップするよう CLI に明示的に指示
--use-bunBun を使用してアプリケーションをブートストラップするよう CLI に明示的に指示
-e または --example [name] [github-url]アプリをブートストラップするための例
--example-path <path-to-example>例へのパスを個別に指定
--reset-preferencesCLI に保存されている設定をリセットするよう明示的に指示
--skip-installCLI にパッケージのインストールをスキップするよう明示的に指示
--yesすべてのオプションに以前の設定またはデフォルト値を使用

例

デフォルトテンプレートで

デフォルトのテンプレートを使用して新しいアプリを作成するには、ターミナルで以下のコマンドを実行します。

ターミナル
npx create-next-app@latest

次に、以下のプロンプトが表示されます。

ターミナル
What is your project named?  my-app
Would you like to use TypeScript?  No / Yes
Would you like to use ESLint?  No / Yes
Would you like to use Tailwind CSS?  No / Yes
Would you like your code inside a `src/` directory?  No / Yes
Would you like to use App Router? (recommended)  No / Yes
Would you like to use Turbopack for `next dev`?  No / Yes
Would you like to customize the import alias (`@/*` by default)?  No / Yes

プロンプトに回答すると、選択した設定で新しいプロジェクトが作成されます。

公式 Next.js の例で

公式の Next.js の例を使用して新しいアプリを作成するには、--example フラグを使用します。例:

ターミナル
npx create-next-app@latest --example [example-name] [your-project-name]

Next.js リポジトリで、利用可能なすべての例とその設定手順のリストを表示できます。

任意の公開 GitHub の例で

任意の公開 GitHub の例を使用して新しいアプリを作成するには、GitHub リポジトリの URL とともに --example オプションを使用します。例:

ターミナル
npx create-next-app@latest --example "https://github.com/.../" [your-project-name]