VRUGD

Appearance

GitHub Desktop のセットアップ ​

本プロジェクトでは、GitHub Desktop を利用した開発フローを推奨しています。 GitHub Desktop を使うことで、Git の操作（クローン、コミット、プッシュ、ブランチ切り替えなど）を直感的に行うことができます。

以下に、GitHub Desktop の導入からプロジェクトクローンまでの手順を説明します。

GitHub Desktop のインストール ​

GitHub Desktop は公式サイトからダウンロードできます。

ダウンロード後、インストーラに従ってセットアップを完了してください。

インストール完了後、初回起動時に GitHub アカウントでログインする画面が表示されますので、 GitHub にサインインしてください。

GitHub Desktop の初期設定 ​

ログインが完了すると、Git 操作に必要な情報を設定します。

  1. メールアドレス・ユーザー名の確認
  2. デフォルトの保存先（ローカルパス）の設定
  3. Git の既定エディタを指定（VSCode 推奨）

これらが自動で設定されていない場合、 File > Options > Git から確認および編集が可能です。

プロジェクトをクローンする ​

GitHub Desktop のメイン画面から次の操作でクローンできます。

  1. File > Clone Repository... を選択
  2. URL タブをクリック
  3. 対象の GitHub リポジトリ URL を入力
  4. クローン先フォルダを選択
  5. Clone をクリック

クローン完了後、自動でリポジトリが開かれます。

TIP

GitHub のブラウザ画面で “Open in GitHub Desktop” を押すことで、ワンクリックでクローン処理を開始することもできます。

Bun 環境をセットアップ ​

GitHub Desktop でクローンしたら、次は Bun のセットアップを行います。

プロジェクトのルートディレクトリをターミナルで開き、以下を実行します。

bun install

依存関係がダウンロードされ、bun.lockb が自動生成されます。

DANGER

GitHub Desktop でコミットするとき、 node_modules はコミットしないようにしてください。 .gitignore により通常は除外されています。

ブランチの操作（GitHub Desktop） ​

GitHub Desktop では次の操作が簡単に行えます。

  • ブランチ作成： 画面上部の Current Branch → New Branch

  • ブランチ切り替え： Current Branch から選択

  • 最新の更新を取得（main → 自分のブランチへ）：

    1. まず main をチェックアウト
    2. Fetch origin → Pull origin
    3. 自分の作業ブランチへ戻る
    4. Branch > Merge into current branch... から main を取り込む

コミットとプッシュ ​

作業を保存するには以下を行います。

  1. 左の変更一覧でコミットしたいファイルをチェック
  2. 下部にコミットメッセージを入力
  3. Commit to <branch-name> を押す
  4. 右上の Push origin で GitHub へアップロード