プロジェクト構造の理解

雛形を動かせるようになったので、この後の作業で扱うファイル・フォルダの役割を先に把握しておきます。App Routerは「どのファイルがどのURLに対応するか」を暗黙のルールで決めているため、構造を理解しておくことがこの後の変更の見通しをよくします。

1. 主要なフォルダ・ファイル

雛形が生成した主要なフォルダ・ファイルの役割は以下の通りです。

フォルダ / ファイル 役割
app/ App Routerが認識するページ・レイアウトを配置するフォルダ。この中のフォルダ構造がそのままURLになる
app/page.tsx ルート(/)に対応するページコンポーネントを配置する
app/layout.tsx すべてのページで共通のレイアウトを定義する。<html> <body> タグもここに書く
app/globals.css プロジェクト全体で読み込まれるグローバルCSSを配置する
public/ 画像などの静的ファイルを配置する。public/logo.png は /logo.png としてブラウザからアクセスできる
next.config.ts Next.jsのビルド設定・機能フラグを記述する
package.json 依存パッケージとnpmスクリプト(dev / build / start / lint)を定義する
tsconfig.json TypeScriptのコンパイラ設定を保持する。@/* エイリアスもここで定義されている
eslint.config.mjs Next.js推奨のESLint設定を保持する
next-env.d.ts Next.jsが自動生成する型定義ファイル。手で編集しない

この後編集する app/page.tsx と app/layout.tsx が app/ フォルダの中にあり、それ以外は雛形が自動生成したビルド設定・型定義であることが把握できていれば、この見出しは完了です。

app/page.tsx の中身の確認

フォルダ構成が把握できたところで、この後何度も編集する app/page.tsx と app/layout.tsx の中身を先に見ておきます。まずは / にアクセスしたときに描画されるページファイルを開き、App Routerでのページコンポーネントの書き方を確認します。

Visual Studio Codeのエクスプローラーから app/page.tsx を開きます。

App Routerのページコンポーネントは、page.tsx に export default された関数として定義します。書き方は以下のとおりです。

export default function 関数名() {
  return (
    // ページのJSX
  );
}

以下は、雛形が生成した app/page.tsx の構造です(実際にはNext.jsロゴやリンクなどのJSXがもう少し長く続いていますが、構造としてはこの形です)。

export default function Home() {
  return (
    <div>
      {/* Next.jsのウェルカム画面のJSX */}
    </div>
  );
}

コードを解説します。

export default function Home() {

/ にアクセスしたときに描画されるページコンポーネントです。App Routerでは app/<パス>/page.tsx の export default されたコンポーネントが、そのままそのURLで描画されるというルールになっています。関数名(Home)自体はURLと無関係で、export default されている関数がそのままページ本体として扱われます。

このファイルには "use client" が書かれていません。前述の通り、App RouterではこれがServer Componentであることを意味します。試しに console.log("hello from server") をコンポーネントの中に書いて保存すると、ブラウザのコンソールではなく、npm run dev を実行しているターミナルの方にログが出力されることで、サーバ側で実行されていることが確認できます(確認後、console.log は削除して構いません)。

app/layout.tsx の中身の確認

続いて、すべてのページで共通の外枠を担当する app/layout.tsx の中身を確認します。この後の見出しでヘッダ・フッタを追加するファイルなので、初期状態でどんな構造になっているかを先に押さえておきます。

app/layout.tsx を開きます。

layout.tsx は、children プロパティを受け取ってページの外枠を定義するコンポーネントです。書き方は以下のとおりです。

export default function 関数名({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    // 外枠のJSX。中に {children} を置く
  );
}

以下は、雛形が生成した app/layout.tsx の骨格部分(Metadata定義やフォント読み込みを除く)です。

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  );
}

コードを解説します。

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {

layout.tsx は、ページの外側を囲む枠を定義するファイルです。children プロパティを受け取る形になっており、ここに各ページ(page.tsx)の中身が差し込まれます。

<html lang="en">
  <body>{children}</body>
</html>

<html> <body> タグをここに書ける点が他のフレームワークと異なります。{children} の位置に、実際のページの中身が挿入される仕組みです。

この後の「レイアウトを共通化する」の見出しで、この layout.tsx に共通ヘッダ・フッタを追加します。

app/page.tsx がURLごとのページを、app/layout.tsx がページの外側を囲む枠を担当していることが把握できていれば、この見出しは完了です。