プロジェクト構造と構成

このページでは、Next.jsにおけるすべてのフォルダとファイルの規約の概要と、プロジェクトを構成するための推奨事項を提供します。

フォルダとファイルの規約

トップレベルフォルダ

トップレベルフォルダは、アプリケーションのコードと静的アセットを整理するために使用されます。

ルートセグメントからパスセグメントへ
appApp Router
pagesPages Router
public配信される静的アセット
srcオプションのアプリケーションソースフォルダ

トップレベルファイル

トップレベルファイルは、アプリケーションの設定、依存関係の管理、ミドルウェアの実行、監視ツールの統合、環境変数の定義に使用されます。

Next.js
next.config.jsNext.jsの設定ファイル
package.jsonプロジェクトの依存関係とスクリプト
instrumentation.tsOpenTelemetryと計装ファイル
middleware.tsNext.jsリクエストミドルウェア
.env環境変数
.env.localローカル環境変数
.env.production本番環境変数
.env.development開発環境変数
.eslintrc.jsonESLintの設定ファイル
.gitignoreGitで無視するファイルとフォルダ
next-env.d.tsNext.jsのTypeScript宣言ファイル
tsconfig.jsonTypeScriptの設定ファイル
jsconfig.jsonJavaScriptの設定ファイル

ファイル規約

_app.js .jsx .tsxカスタムApp
_document.js .jsx .tsxカスタムDocument
_error.js .jsx .tsxカスタムエラーページ
404.js .jsx .tsx404エラーページ
500.js .jsx .tsx500エラーページ

ルート

フォルダ規約
index.js .jsx .tsxホームページ
folder/index.js .jsx .tsxネストされたページ
ファイル規約
index.js .jsx .tsxホームページ
file.js .jsx .tsxネストされたページ

ダイナミックルート

フォルダ規約
[folder]/index.js .jsx .tsxダイナミックルートセグメント
[...folder]/index.js .jsx .tsxキャッチオールルートセグメント
[[...folder]]/index.js .jsx .tsxオプションキャッチオールルートセグメント
ファイル規約
[file].js .jsx .tsxダイナミックルートセグメント
[...file].js .jsx .tsxキャッチオールルートセグメント
[[...file]].js .jsx .tsxオプションキャッチオールルートセグメント

On this page