awesome-hacks
Docs

簡単な環境構築

簡単に環境構築する手順

最終更新:2026/03/31

備忘録がてら、簡単にnext.jsの環境構築する手順まとめ

前提

  • Next.js
  • Biome使用
  • TypeScript使用
  • pnpm使用
  • SourceTreeで開くところまで

1. プロジェクトフォルダの作成

Finderなどで任意の場所にディレクトリ作成

2. プロジェクトの作成

一括指定

1で用意したディレクトリ内に移動して下記を実行(またはエディタで当該ディレクトリを開く)

npx create-next-app@latest . --ts --tailwind --biome --app --import-alias "@/*" --use-pnpm
pnpm dev

http://localhost:3000 開いて確認

--ts

TypeScriptで作る .jsじゃなくて .ts / .tsx

--tailwind

Tailwind CSSを最初から入れる tailwind.config.ts など自動生成

--biome

Biomeを入れる

--app

App Router構成にする(/app ディレクトリ方式)

--import-alias "@/*"

パスエイリアス設定 import Button from "../../../components/Button"import Button from "@/components/Button"と書けるようになる

--use-pnpm

パッケージマネージャをpnpmにする

注意事項(2026.3.31時点)

最近は下記が聞かれる。

% npx create-next-app@latest . --ts --tailwind --biome --app --import-alias "@/*" --use-pnpm
Need to install the following packages:
create-next-app@16.2.1
Ok to proceed? (y) y

? Would you like to use React Compiler? › No / Yes

=> Next.js最新系で追加されたもので、Reactのパフォーマンス最適化を自動でやる仕組みだがまだ新しいため、「No」でいい様子

? Would you like your code inside a `src/` directory? › No / Yes

=> srcディレクトリ配下に作成するかどうか。作成しないとpackage.jsonなどの設定ファイルと混ざるので「Yes」でOK

? Would you like to include AGENTS.md to guide coding agents to write up-to-date Next.js code? › No / Yes

=> AI(コード生成ツール。CopilotやCursorエージェント)向けのルールブックを作成するかどうか。あっても困らないので「Yes」でOK

ちなみに、通常手順は下記

基本として、Next.jsのテンプレを使って環境構築する場合のコマンドは下記

npx create-next-app@latest .
  • npx:インストールせずに一時的に実行
  • create-next-app@latest:最新のNext.jsテンプレを使う
  • .:今いるディレクトリに作る

しかし、上記だと対話形式で各種オプション設定が必要

2. Git 初期化

基本は不要。

初期化状態の確認

下記と出たら未初期化のため必要

% git status
fatal: not a git repository
%

初期化

git init

3. .gitignore確認

既に.gitignoreは作成済みだが、下記が書かれていることを確認

  • node_modules
  • .next
  • .env

4. 初回コミット

基本は不要。(create-next-app が 初回コミットまでやっているため)

git add .
git commit -m "init: create next app"

コミット済みかの確認

下記が出ていれば初回コミット済み

% git log --oneline
81e8636 (HEAD -> main) Initial commit from Create Next App
%

5. Githubリポジトリ作成

ブラウザで GitHub にアクセス

  • 「New repository」
  • 名前:任意だが、作成したプロジェクトディレクトリ名に合わせるのが一般的
  • READMEは作らない(重要)

6. リモート接続

GitHubで表示される通りで良い

git remote add origin https://github.com/ユーザー名/リポジトリ名.git
git branch -M main
git push -u origin main

こちらで連携完了

7. SourceTreeで開く

新規 > 「既存のローカルリポジトリを開く」