RepoShelf Support

Contact: support@floppy8.win
When reporting a problem, please attach the diagnostics from Settings → About → Copy Diagnostics (it contains your repository names, so please send it by email rather than posting it publicly).

Getting started (5 minutes)

  1. Open Settings → Add Token and paste a read-only access token for your Git host (see below; optional for public repositories).
  2. Open Repositories → +, enter the owner and repository name, and pick a branch.
  3. Choose a destination folder in the Files app — this is where the repository content will be stored.
  4. Tap Save, then tap the sync button. Your files appear in the Files app and can be opened from any other app.
  5. Optional: add the sync button to Control Center, or enable Background Updates in Settings.

Creating a read-only token

GitHub

Settings → Developer settings → Personal access tokens → Fine-grained tokens. Select only the repositories you need, with permission Contents: Read-only.

GitLab (gitlab.com and self-hosted)

User settings → Access tokens, scope read_api. For a project access token, choose role Reporter or higher — the Guest role cannot read repository content even with the right scope.

Bitbucket

Open the repository → Repository settings → Access tokens → create a Repository Access Token with Repositories: Read. ⚠️ Atlassian account "API tokens" (starting with ATATT) are not supported — they use a different authentication method. Use a Repository Access Token instead.

FAQ

A repository shows a warning message in the list

That is the result of the last sync. Common causes: an expired or insufficient token (check the token and its permissions), or the repository/branch name changed. Syncing successfully clears the message.

Background sync doesn't seem to run

Check iOS Settings → General → Background App Refresh — it must be enabled for RepoShelf. Note that iOS decides the actual timing of background refreshes; they are best-effort, not exact. You can always sync manually or from Control Center.

I can't add a second repository

The free version includes one repository. Unlock unlimited repositories with a one-time purchase (Settings → Unlimited Repositories). Already purchased? Use Restore Purchases.

Which folder should I choose as the destination?

Any folder in the Files app (e.g. "On My iPhone"). To read notes in another app (such as an editor that opens folders), choose a folder that app can access.

RepoShelf サポート

お問い合わせ: support@floppy8.win
不具合のご連絡には、設定 → 情報 → 診断情報をコピー の内容を添えていただくと スムーズです（あなたのリポジトリ名が含まれるため、公開の場ではなくメールでお送りください）。

はじめかた（5分）

  1. 設定 → トークンを追加 で、Git ホストの読み取り専用トークンを貼り付けます （作り方は下記。公開リポジトリだけなら省略可）。
  2. リポジトリ → + で owner とリポジトリ名、ブランチを入力します。
  3. 保存先フォルダを「ファイル」アプリ内から選びます — ここにリポジトリの 内容が保存されます。
  4. 保存して同期ボタンをタップ。ファイルアプリに内容が現れ、他のアプリから 開けるようになります。
  5. お好みで: コントロールセンターに同期ボタンを追加、または設定でバックグラウンド更新を有効に。

読み取り専用トークンの作り方

GitHub

Settings → Developer settings → Personal access tokens → Fine-grained tokens。 対象リポジトリだけを選び、権限は Contents: Read-only にします。

GitLab（gitlab.com・セルフホスト）

User settings → Access tokens で scope read_api。プロジェクトアクセストークンを 使う場合はロールを Reporter 以上にしてください — Guest はスコープが正しくても リポジトリを読めません。

Bitbucket

対象リポジトリ → Repository settings → Access tokens で Repository Access Token（Repositories: Read）を作成します。 ⚠️ Atlassian アカウントの「API トークン」（ATATT で始まるもの）は認証方式が異なるため 使えません。必ず Repository Access Token をご利用ください。

よくある質問

一覧のリポジトリに警告メッセージが出ている

直近の同期の結果です。よくある原因: トークンの期限切れ・権限不足（トークンと権限を確認）、 リポジトリ名やブランチ名の変更。同期が成功すると表示は消えます。

バックグラウンド更新が動かない

iOS の 設定 → 一般 → Appのバックグラウンド更新 が RepoShelf に対して 有効か確認してください。実行タイミングは iOS が決めるため、時刻どおりには動きません （ベストエフォート）。手動同期・コントロールセンターからの同期はいつでも使えます。

2件目のリポジトリが追加できない

無料版で登録できるのは1件です。買い切りの「リポジトリ無制限アンロック」で無制限になります （設定 → リポジトリ無制限アンロック）。購入済みの場合は購入を復元をお試しください。

保存先はどのフォルダを選べばいい？

「ファイル」アプリ内の任意のフォルダ（例:「このiPhone内」）を選べます。他のアプリ （フォルダを開けるエディタ等）で読みたい場合は、そのアプリがアクセスできるフォルダを選んでください。