Skip to main content

​
Git連携

Jeliqで生成したコードをGitHubなどの外部リポジトリにエクスポートする方法を解説します。エクスポートしたコードは、エンジニアが継続開発や本番デプロイに利用できます。

​
Git連携でできること

コードのエクスポート

生成されたソースコードをGitHubなどの外部リポジトリにプッシュできます。

バックアップ

外部リポジトリに保存することで、コードの安全なバックアップになります。

チーム開発

エンジニアチームがコードを取得し、継続開発を行えます。

本番デプロイ

Vercelなどと連携し、本番環境へのデプロイが可能になります。

​
エクスポートの手順

1

変更を保存する

エクスポート前に、変更履歴で最新の変更を「保存」して確定してください。
未保存の変更はエクスポートされません。必ず保存を完了させてからエクスポートしてください。
2

変更履歴タブを開く

画面上部の「変更履歴」ボタンをクリックして、変更履歴タブを開きます。
3

エクスポートボタンをクリック

画面下部の「エクスポート」ボタンをクリックします。
4

リポジトリ情報を入力

エクスポートダイアログで、以下の情報を入力します。
項目説明例
リモートリポジトリURLプッシュ先のGitリポジトリURLhttps://github.com/username/repo
アクセストークン認証に使用するトークンghp_xxxxxxxxxxxx
ブランチ名プッシュ先のブランチ名main, develop
5

エクスポートを実行

「エクスポート」ボタンをクリックして、エクスポートを実行します。
エクスポートには数分かかる場合があります。完了するまでお待ちください。

​
GitHubでの事前準備

​
1. リポジトリの作成

GitHubで新しいリポジトリを作成します。
  1. GitHubにログイン
  2. 「New repository」をクリック
  3. リポジトリ名を入力
  4. 「Private」を選択（推奨）
  5. 「Create repository」をクリック
初回は空のリポジトリを作成してください。README.mdなどは自動生成しないことをお勧めします。

​
2. Personal Access Tokenの作成

GitHubの認証にはPersonal Access Token（PAT）が必要です。
1

GitHubの設定を開く

GitHubにログインし、右上のプロフィールアイコンから「Settings」を選択します。
2

Developer settingsを開く

左サイドバーの一番下にある「Developer settings」をクリックします。
3

Personal access tokensを作成

「Personal access tokens」→「Tokens (classic)」→「Generate new token (classic)」をクリックします。
4

権限を設定

以下の権限を付与します：
  • repo（リポジトリへのフルアクセス）
トークンは一度しか表示されません。安全な場所に保管してください。

​
エクスポートされるファイル

エクスポートされるリポジトリには、以下のファイル・フォルダが含まれます。 
your-app/
├── src/
│   ├── app/              # Next.js App Router（ページ）
│   ├── components/       # Reactコンポーネント
│   ├── lib/              # ユーティリティ関数
│   └── types/            # TypeScript型定義
├── supabase/
│   ├── migrations/       # DBマイグレーションファイル
│   └── config.toml       # Supabase設定
├── public/               # 静的ファイル
├── package.json          # 依存関係
├── tsconfig.json         # TypeScript設定
├── next.config.js        # Next.js設定
└── README.md             # プロジェクト説明

​
よくある質問

よくある原因と対処法：
  1. アクセストークンが無効
    • トークンの有効期限を確認
    • 権限（repo）が付与されているか確認
  2. リポジトリURLが間違っている
    • URLの形式を確認（https://github.com/ユーザー名/リポジトリ名）
  3. ブランチが存在しない
    • 指定したブランチがリポジトリに存在するか確認
    • 初回はmainまたは空のリポジトリを使用
  4. ネットワークエラー
    • インターネット接続を確認
    • しばらく待ってから再試行
はい、同じリポジトリに上書きでエクスポートできます。ただし、リポジトリ側で行った変更は上書きされる可能性があるため、注意が必要です。推奨の運用方法：
  • Jeliq専用のブランチ（例：jeliq-export）にエクスポート
  • エンジニアが別ブランチで開発
  • 必要に応じてマージ
現在のバージョンでは、GitHubのみ動作確認済みです。GitLab、Bitbucketなどの他のサービスへの対応は今後のアップデートで検討中です。
はい、プライベートリポジトリにエクスポートできます。セキュリティの観点から、プライベートリポジトリの使用を推奨します。
インポート機能（外部リポジトリからJeliqへの取り込み）は、現在のバージョンでは非公開です。今後のアップデートで提供予定です。

​
セキュリティに関する注意

アクセストークンの取り扱い
  • アクセストークンは他者と共有しないでください
  • 定期的にトークンを更新することを推奨します
  • 不要になったトークンは削除してください
  • トークンには最小限の権限のみを付与してください

​
次のステップ

エクスポートが完了したら、以下のドキュメントを参考にしてください。

エンジニアへの引き継ぎ

エンジニアとの協業方法

ローカル環境セットアップ

エンジニア向けの環境構築手順