Documentation

Step 1: Go to GitHub Settings

Visit: github.com/settings/tokens

Step 2: Generate New Token

Click "Generate new token (classic)"

Step 3: Configure Token

• Note: Give it a descriptive name like "RepoPost"
• Expiration: Choose 90 days or custom (recommended for security)
• Scopes: Check the repo checkbox (full control of private repositories)

Step 4: Generate and Copy

Click "Generate token" at the bottom

Copy the token immediately - you won't see it again!

Step 5: Add to RepoPost

Open RepoPost, paste your token, and tap "Connect GitHub"

1. Select Repository

In the "To:" field, tap the repository you want to publish to.

2. Write Your Title

In the "Subject:" field, write your post title. RepoPost will automatically generate a URL-friendly slug.

3. Write Your Content

In the body field, write your post content in plain text or markdown.

I'm writing my first post with RepoPost!

This is so much easier than navigating GitHub mobile.

## Next Steps

- Write more posts
- Configure custom signatures
- Enjoy mobile-first blogging

4. Select Signature (Optional)

Choose a signature template to append to your post.

5. Publish

Tap "Publish" and your post is live!

Default Path

By default, RepoPost saves posts to:

Common Path Examples

• content/blog/ - Next.js, Gatsby
• posts/ - Jekyll, Hugo
• src/content/ - Astro
• _posts/ - Jekyll (underscore format)

How to Change Path

1. Open Settings
2. Under "Repository Paths", tap Edit next to your repo
3. Enter the path where your blog posts are stored
4. Tap Save

Default Signatures

RepoPost includes three default signatures:

• Standard Signature - Social media links
• Product Launch - Links to your products
• No Signature - Blank (no signature added)

Creating Custom Signatures

1. Open Settings
2. Scroll to "Signatures"
3. Tap "+ Create New Signature"
4. Enter a name (e.g., "Product CTA")
5. Write your signature content in markdown
6. Tap Save

Example Signature

---

**What I'm building:** RepoPost - mobile-first publishing for GitHub blogs

**Follow along:** [@SelfCEOstrategy](https://twitter.com/SelfCEOstrategy)

**Current projects:** [offer.guide](https://offer.guide) | [Mory](https://moryhq.com)

Your Token is Private

RepoPost stores your GitHub token locally on your device using iOS Keychain (encrypted). It never sends your token to any server except GitHub's official API.

Token Expiration

We recommend setting your token to expire after 90 days. When it expires:

1. Go to GitHub and create a new token
2. Open RepoPost Settings
3. Tap "Disconnect GitHub"
4. Reconnect with your new token

If Your Phone is Lost

1. Go to github.com/settings/tokens
2. Find your RepoPost token
3. Click "Delete"
4. The token stops working immediately

Keep Your Device Secure

• Use Face ID or Touch ID
• Set a strong passcode
• Don't share your token with anyone
• Don't jailbreak your device

Does RepoPost work with private repositories?

Yes! As long as your GitHub token has repo permissions, you can publish to both public and private repositories.

Can I edit existing posts?

Not yet, but this feature is coming soon. For now, you can edit posts directly on GitHub or in your code editor.

What markdown features are supported?

RepoPost creates standard markdown files. All markdown features supported by your blog platform will work (headings, lists, links, code blocks, images, etc.).

Can I add images to my posts?

Image upload is coming soon. For now, you can link to images hosted elsewhere using standard markdown syntax: ![alt text](url)

Does RepoPost cost anything?

RepoPost will be $9.99/month with a 7-day free trial when it launches in January 2026.

Can I use RepoPost on Android?

Not yet. RepoPost is iOS-only at launch. Android support may come later based on demand.

Where is my data stored?

RepoPost doesn't store any of your data. Your GitHub token is stored locally on your device, and all posts go directly to your GitHub repository. No cloud storage, no backend database.

I added a new repository but don't see it in RepoPost

Go to Settings and tap the "Refresh Repositories" button. RepoPost will fetch your latest repos from GitHub.