Next.js プロジェクトの作成

まずは公式のスキャフォールディングツール create-next-app を使い、Next.jsプロジェクトの雛形を生成します。空のフォルダから手作業で必要ファイルを揃えるより、公式が推奨する構成を一発で作成できるため、新規Next.jsプロジェクトはほぼ常にこのツールから始めます。

1. プロジェクト雛形の生成

create-next-app は対話形式でTypeScript・App Router・Tailwindなどの初期設定を1つずつ聞いてくれるスキャフォールディングツールで、コマンド1本でNext.jsが必要とするファイル一式が揃った状態のプロジェクトを作成できます。まずはこのツールを使って、以降のハンズオンの土台になる雛形を生成します。

任意の場所に my-next-app フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した my-next-app フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。

my-next-app  ← このフォルダを作成

以下のコマンドで、npm がインストールされていることを確認します。npx は npm に同梱されているため、npm のバージョンが確認できれば npx も利用できます。

npm --version

以下のように npm のバージョンが表示されれば、インストールは確認できています。

11.x.x

バージョンが表示されない場合は、Node.jsをインストールしよう を先に実施してください。

インストールが確認できたら、以下のコマンドでNext.jsプロジェクトを、いま開いているカレントフォルダに生成します。

npx create-next-app@latest .

npx はローカルにインストールされていないコマンドをその場でダウンロードして実行するNode.js標準のツールで、create-next-app@latest の部分でNext.js公式スキャフォールディングツールの最新版を実行しています。直後の . は「カレントフォルダ(いま開いている my-next-app)に生成する」ことを指定しています。

実行すると、以下の質問が表示されます。

  • Would you like to use the recommended Next.js defaults? → Yes, use recommended defaults を選択して Enter

Yes を選ぶと、Next.jsの推奨構成で雛形が一括生成されます。

回答が終わると、必要な依存パッケージが自動でインストールされ、いま開いている my-next-app フォルダに雛形が生成されます。以下のような実行結果が表示されれば成功です。

Success! Created my-next-app at /path/to/my-next-app

Visual Studio Codeのサイドバーには、以下のような構成が表示されます。

my-next-app/
├── app/
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
├── public/
├── .gitignore
├── eslint.config.mjs
├── next-env.d.ts
├── next.config.ts
├── package-lock.json
├── package.json
├── postcss.config.mjs
├── README.md
└── tsconfig.json

2. 開発サーバの起動

雛形を生成しただけではブラウザで動作を確認できないため、開発サーバを起動します。開発サーバはコードの変更を検知して自動的にリビルド・再読み込みしてくれるため、以降の変更もこのサーバを起動したまま確認できます。

Visual Studio Codeのターミナルで、以下のコマンドを実行します。

npm run dev

npm run dev は package.json の scripts に定義された dev スクリプトを実行するコマンドです。Next.jsの雛形では、この dev スクリプトが next dev を実行するように設定されています。Next.js 16以降ではTurbopackが標準になっているため、--turbopack オプションを付けなくても自動的にTurbopackで起動します。

以下のような実行結果が表示され、Ready in ... のメッセージが出れば起動完了です。

> my-next-app@0.1.0 dev
> next dev

   ▲ Next.js 16.x.x (Turbopack)
   - Local:        http://localhost:3000
   - Network:      http://192.168.x.x:3000

 ✓ Ready in 1.2s

ブラウザで http://localhost:3000 を開くと、Next.jsのウェルカム画面が表示されます。左上に NEXT.js のロゴ、中央に To get started, edit the page.tsx file. の見出しと、Deploy Now / Documentation の2つのボタンが並んで表示されていれば、開発サーバが正常に動作しています。

💡 ポイント
開発サーバは、以降のハンズオンでも起動したままにしておきます。コードを変更・保存するたびに、ブラウザが自動的にリロードされて反映を確認できます。停止したい場合は、ターミナルで Ctrl + C を押してください。