セットアップ

Reactを動かすには、.tsx ファイルをブラウザで動くJavaScriptに変換するビルドツールが必要です。ここでは、Reactの新規プロジェクトを作るときによく使われるVite(ヴィート)を使って、最小のReactプロジェクトを準備し、開発サーバでブラウザに表示できるところまでを確認します。

1. プロジェクトの初期化

まず、Reactを扱うための空のプロジェクトを作り、Viteによる開発サーバの起動までを行います。

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

react-practice  ← このフォルダを作成

以下のコマンドで、npmがインストールされていることを確認します。

npm --version

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

11.x.x

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

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

npm create vite@latest . -- --template react-ts

npm create vite@latest はViteの公式スキャフォールディングコマンドで、直後の . は「カレントフォルダ(いま開いている react-practice)に生成する」ことを指定し、-- --template react-ts の部分で「React + TypeScript のテンプレート」を指定しています。

実行中に対話プロンプトが順に出るので、以下のように答えます。

  • Package name: → そのまま Enter(フォルダ名の react-practice が使われます)
  • Ok to proceed? (y) → y を入力して Enter
  • Which linter to use? → Oxlint を選択して Enter
  • Install with npm and start now? → Yes を選択して Enter

最後の Install with npm and start now? に Yes と答えると、Viteがスキャフォールディング・依存パッケージのインストール・開発サーバの起動までまとめて実施します。以下のような実行結果が表示されれば、開発サーバの起動まで完了しています。

◇  Scaffolding project in /path/to/react-practice...
◇  Installing dependencies with npm...

added 27 packages, and audited 28 packages in 2s

found 0 vulnerabilities

◇  Starting dev server...

> react-practice@0.0.0 dev
> vite

  VITE v8.x.x  ready in 500 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help

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

react-practice/
├── node_modules/
├── public/
├── src/
│   ├── App.css
│   ├── App.tsx
│   ├── assets/
│   ├── index.css
│   ├── main.tsx
│   └── vite-env.d.ts
├── .gitignore
├── index.html
├── package.json
├── tsconfig.json
├── tsconfig.node.json
└── vite.config.ts

以降の節で編集するファイルは、主に src/App.tsx の1つだけです。他のファイルはViteの設定や雛形として初期状態のまま使います。

💡 ポイント
このコマンドを実行したターミナルは開発サーバに占有されたままになります。以降のコマンドを実行するときは、Visual Studio Codeで「ターミナル」→「新しいターミナル」から別のターミナルを開いてください。開発サーバを止めたい場合は、動いているターミナルで Ctrl + C を押します。

2. 動作確認

セットアップの最後で開発サーバが起動しているので、ブラウザから表示できるかを確認します。

ブラウザで http://localhost:5173 を開くと、React と Vite のロゴを重ねたイラスト、Get started の大きな見出し、Edit src/App.tsx and save to test HMR の案内、Count is 0 の薄紫色のボタン、下部に Documentation と Connect with us のカードが並んだ、Viteのウェルカム画面が表示されます。

Count is 0 のボタンをクリックすると、Count is 1・Count is 2 と数字が1ずつ増えていきます。以下は4回クリックしたあとの状態です。

クリックのたびにボタン内の数字が追随して変われば、Reactの開発サーバが正しく動作していることが動作確認できます。

⚠️ ポートが 5173 以外に切り替わる場合
別のプロセスがすでに 5173 番ポートを使っている場合、Viteは自動的に 5174・5175 など次に空いているポートを使います。ブラウザで開くURLは、ターミナルに表示されている Local: http://localhost:XXXX/ のポート番号に合わせてください。