GETTING STARTED
事前準備
TypeScriptの基本文法を読み書きできる方に向けた教材です。説明を読むだけなら、Session 00へ進めます。
環境を準備する
演習は、各Sessionの「演習」ページのブラウザ内で解けます。手元のエディタで解く場合は、下の手順でリポジトリをcloneして依存パッケージをインストールします。
-
使うブラウザをそろえる
デスクトップ版ChromeまたはEdgeを用意する
演習のコードは、ブラウザ内の隔離環境で動きます。ローカルPCのファイルには触りません。データベース、Docker、外部サービスのAPIキーは必要ありません。
-
演習の進め方を知る
各Sessionの「演習」ページで進める
「演習」ページで誤った変更の一覧を確認し、それらを検出する仕組み(Linterのルール、型のテスト、テスト)を追加します。変更によって検出できる種類が異なるため、複数の種類が必要な Session もあります。「検出を検証する」を押すと、追加した仕組みが誤った変更を検出するか、正しいコードを誤って検出しないかが表に表示されます。
作業内容は、そのブラウザに保存されます。ページを閉じても、同じブラウザで開き直せば、続きから進められます。別のブラウザや別のPCには引き継がれません。
詰まったときは、ページの「解答の例を見る」を開いてください。
環境構築で問題が発生した場合は、トラブルシューティングを確認してください。
ローカル環境でも動かしたい人向けの準備
ブラウザで解く場合は不要です。手元のエディタで演習を解く場合と、教材サイトやデモ画面を手元で起動する場合に使います。
-
使うツールをそろえる
Node.js・pnpm・Gitを用意する
Node.js 20以上、pnpm 9.12.0、Gitを用意してください。
-
教材をローカル環境に置く
リポジトリをcloneする
作業する場所で、次のコマンドを実行してください。
Terminalgit clone https://github.com/iwasa-kosui/fp-with-ts-hands-on.git -
教材サイトを表示する
依存関係を入れて教材を起動する
続けて、次のコマンドを実行してください。
Terminalcd fp-with-ts-hands-on pnpm install --frozen-lockfile pnpm devターミナルに表示されたlocalhostのURLをChromeまたはEdgeで開いてください。終了するときは
Ctrl+Cを押してください。Session 00のデモ画面は、
pnpm demo:00で起動します。Session 00の「あとで読む」のページにも、この手順を載せています。
ハンズオンを開催する方は、ファシリテーターガイドも参照できます。