WAN NYAN CLINIC

GETTING STARTED

事前準備

TypeScriptの基本文法を読み書きできる方に向けた教材です。説明を読むだけなら、Session 00へ進めます。

環境を準備する

演習は、各Sessionの「演習」ページのブラウザ内で解けます。手元のエディタで解く場合は、下の手順でリポジトリをcloneして依存パッケージをインストールします。

  1. 使うブラウザをそろえる

    デスクトップ版ChromeまたはEdgeを用意する

    演習のコードは、ブラウザ内の隔離環境で動きます。ローカルPCのファイルには触りません。データベース、Docker、外部サービスのAPIキーは必要ありません。

  2. 演習の進め方を知る

    各Sessionの「演習」ページで進める

    「演習」ページで誤った変更の一覧を確認し、それらを検出する仕組み(Linterのルール、型のテスト、テスト)を追加します。変更によって検出できる種類が異なるため、複数の種類が必要な Session もあります。「検出を検証する」を押すと、追加した仕組みが誤った変更を検出するか、正しいコードを誤って検出しないかが表に表示されます。

    作業内容は、そのブラウザに保存されます。ページを閉じても、同じブラウザで開き直せば、続きから進められます。別のブラウザや別のPCには引き継がれません。

    詰まったときは、ページの「解答の例を見る」を開いてください。

環境構築で問題が発生した場合は、トラブルシューティングを確認してください。

ローカル環境でも動かしたい人向けの準備

ブラウザで解く場合は不要です。手元のエディタで演習を解く場合と、教材サイトやデモ画面を手元で起動する場合に使います。

  1. 使うツールをそろえる

    Node.js・pnpm・Gitを用意する

    Node.js 20以上、pnpm 9.12.0、Gitを用意してください。

  2. 教材をローカル環境に置く

    リポジトリをcloneする

    作業する場所で、次のコマンドを実行してください。

    Terminal
    git clone https://github.com/iwasa-kosui/fp-with-ts-hands-on.git
  3. 教材サイトを表示する

    依存関係を入れて教材を起動する

    続けて、次のコマンドを実行してください。

    Terminal
    cd fp-with-ts-hands-on
    pnpm install --frozen-lockfile
    pnpm dev

    ターミナルに表示されたlocalhostのURLをChromeまたはEdgeで開いてください。終了するときは Ctrl+C を押してください。

    Session 00のデモ画面は、pnpm demo:00 で起動します。Session 00の「あとで読む」のページにも、この手順を載せています。

ハンズオンを開催する方は、ファシリテーターガイドも参照できます。