開発したプロダクトをGitHubで公開するまでの手順をまとめました。個人開発者向けに、必要最小限の設定で効率的に公開する方法を解説します。

Vibe Codingのワークフロー 実行編3 - GitHubでバージョン管理しながらClaude Code開発する方法 Vibe Codingのワークフロー 実行編3 - GitHubでバージョン管理しながらClaude Code開発する方法 効率的で安全なClaude Code開発のために、GitHubでバージョン管理を組み合わせた実践的な開発ワークフローをご紹介します。これにより、いつでも前の状態に戻れる安心感と、定期的な開発進捗管理が可能になります。なぜGitHub + Claude Code... 続きを読む

    1. ビルドとリリース準備

    1.1 アプリケーションのビルド

    # macOS用ビルド
    npm run build:mac
    
    # 生成されるファイル(dist/フォルダ内)
    # - [プロダクト名]-1.0.0-arm64.dmg (Apple Silicon用)
    # - [プロダクト名]-1.0.0-arm64-mac.zip
    # - [プロダクト名]-1.0.0.dmg (Intel Mac用)
    # - [プロダクト名]-1.0.0-mac.zip
    

    1.2 Gitタグの作成とプッシュ

    既存のタグを確認する
    cd "/Volumes/CT1000P3/pCloud(CT1000P3)/Github/wp-plugin-menuitem-copy-paste"
    
    git tag                            # ローカルのタグ一覧を表示
    git ls-remote --tags origin        # リモート(GitHub)のタグ一覧を表示
    
    個別でタグを削除する
    # v1.0.0を削除する例
    git tag -d v1.0.0                  # ローカルのタグを削除
    git push origin :refs/tags/v1.0.0  # リモートのタグを削除
    
    # 他のタグも同様に削除
    git tag -d v1.0.1
    git push origin :refs/tags/v1.0.1
    
    全タグを一括削除(クリーンスタート)
    git tag | xargs git tag -d         # ローカルの全タグを削除
    
    # リモートの全タグを削除
    git ls-remote --tags origin | awk '{print $2}' | sed 's|refs/tags/||' | xargs -I {} git push origin :refs/tags/{}
    
    GitHubにプッシュ
    git add .
    git commit -m "Release v1.0.0"
    git push origin                    # プッシュ
    
    git tag -a v1.0.0 -m "Release v1.0.0 - Initial stable release" # 最新コミットにバージョンタグを付ける
    git push origin v1.0.0             # バージョンタグをプッシュ
    

     

    ⚠️ 注意: Huskyのpre-pushフックでエラーが出る場合は、先にコードフォーマットを修正:

    npm run format:fix
    npm run lint:fix
    git add .
    git commit -m "fix: Code formatting"
    git push origin v1.0.0
    

    2. GitHub Releasesでリリース作成

    2.1 リリースページへアクセス

    1. リポジトリページの「Releases」をクリック
    2. Create a new release」もしくは「Draft a new release」ボタンをクリック

    2.2 リリース情報の入力

    # タグを選択
    🏷 Tag: v1.0.0 (既存のタグを選択)
    
    # リリースタイトル(Release title:)
    [プロダクト名] v1.0.0
    
    # リリースノート(Release notes:)
    
    ## 主要機能
    - 複数の検索・置換パターンを一括実行
    
    ## パフォーマンス
    - **処理速度**: 1000ファイルを0.97秒で処理(目標30秒を大幅クリア)
    - **UI応答性**: 100ms以内達成(実測0.04ms)
    - **メモリ使用量**: 10MB(目標200MBの95%削減)
    
    ## 動作環境
    - macOS 10.14以降(Intel/Apple Silicon両対応)
    - Node.js不要(スタンドアロン動作)
    
    ### ダウンロード(macOS版)
    - `MultiGrepReplacer-1.0.0.dmg` (インストーラー)
    - `Multi Grep Replacer-1.0.0-universal-mac` (zip版)
    
    ### ダウンロード(Windows版)Windows版
    - `MultiGrepReplacer-Setup-1.0.0.exe` (インストーラー)
    
    --------
    
    ## ドキュメント
    - [README.md(日本語)](README.md)
    

    2.3 配布ファイルのアップロード

    Attach binaries by dropping them here or selecting them」にドラッグ&ドロップ:

    • [プロダクト名]-1.0.0.dmg
    • [プロダクト名]-1.0.0-universal-mac.zip`
    • [プロダクト名]-1.0.0.exe
    • sample-configs.zip(あれば、設定テンプレート)

    Publish release」をクリックして公開!


    3. リポジトリのPublic化

    3.1 Private → Public への変更

    1. リポジトリの ⚙ Settings タブをクリック
    2. 最下部の「Danger Zone」までスクロール
    3. Change repository visibility」をクリック
    4. Change to public」を選択
    5. リポジトリ名を入力して確認
    6. I understand, change repository visibility」をクリック

    3.2 公開前チェックリスト

    • ✅ APIキーや秘密情報が含まれていない
    • .gitignoreで不要ファイル除外済み
    • ✅ LICENSEファイル設置済み(MIT License)

    4. リポジトリ基本設定

    4.1 About セクションの設定(最重要)

    リポジトリページ右側 > About右の > 歯車アイコン⚙️から:

    Description: 
    高速で使いやすい複数パターン一括置換ツール。Electron製デスクトップアプリ
    
    Website:
    https://github.com/[username]/[repository]/releases
    
    Topics:
    electron, desktop-app, grep, replace, text-processing,
    developer-tools, productivity, macos
    
    Include in the home page:
    ✅ Releases (プロフィールページに表示)
    

    4.2 READMEバッジの追加

    (Claudeに作成してもらうのが無難です)

    ![License](https://img.shields.io/badge/license-MIT-blue.svg)
    ![Platform](https://img.shields.io/badge/platform-macOS-lightgrey)
    ![Release](https://img.shields.io/github/v/release/[username]/[repository])
    

    5. セキュリティ設定

    5.1 ブランチ保護(個人開発では任意)

    Settings → Branches → Add classic branch protection rule:

    Branch name pattern: main
    
    # 個人開発の最小限設定:
    ✅ Require a pull request before merging
    (その他はすべてOFF)
    
    # 注意:以下は絶対にチェックしない
    ❌ Allow force pushes
    ❌ Allow deletions
    

    5.2 Dependabotの設定(デフォルトで有効)

    Settings → Advanced Security

    Dependabot alerts:           Enable    # デフォルトで有効
    Dependabot security updates: Enable    # デフォルトで有効
    

    依存関係の脆弱性を自動検出・更新提案してくれます。


    6. その他の設定

    6.1 不要な機能の無効化

    Settings → General:

    
    ❌ Wikis(ドキュメントはREADME.mdで十分)
    ❌ Issues(個人開発では設定不要。対応義務が発生するため)
    ❌ Sponsorships(ユーザー数が増えてから検討)
    ❌ Discussions(個人開発では管理が大変)
    ❌ Projects(個人開発では不要)
    

    Settings → GitHub Pages(不要な場合):

    
    Settings → Pages → Branch → None
    

    ✅ 最終チェックリスト

    必須項目:

    • リポジトリをPublicに変更
    • LICENSEファイル(MIT)設置
    • Aboutセクション設定(Description, Website, Topics)
    • README.md整備
    • Releasesでビルド済みファイル公開

    推奨項目:

    • Dependabot有効化(デフォルトで有効)
    • 最小限のブランチ保護
    • READMEにバッジ追加

    不要項目:

    • ❌ GitHub Pages(デスクトップアプリなので)
    • ❌ Wikis, Issues, Sponsorships, Discussions, Projects(対応義務を避ける)

    これで、プロダクトのGitHub公開が完了です!個人開発では、必要最小限の設定で始めて、ユーザーが増えてから機能を追加していきましょう。


    関連記事

    永久無料で使えるAIコードレビュー『CodeRabbit』で全コードレビューしてもらう方法 CodeRabbitは無料でAIコードレビューが受けられるサービスです。GitHubのPublicリポジトリなら永久無料。導入方法からPRの作成、無料で全コードレビューを受けるコツまで、初心者向けに解説します。  続きを読む CodeRabbit CLIとClaude Codeを連携してAIコードレビューから自動修正する方法 前回の記事「CodeRabbitで全コードレビューしてもらう方法」では、GitHub上でPRを作成してAIコードレビューを受ける方法を解説しました。 永久無料で使えるAIコードレビュー『CodeRabbit』で全コードレビューしてもらう方法 ...  続きを読む