Direct GitHub Sync & 1-Click Push

How GitHub Sync Works#

In GitHub, your profile README lives in a special repository matching your exact username:

https://github.com/<your-username>/<your-username>/README.md

MonoForge provides an authenticated REST API workflow that reads and updates this repository directly without requiring manual copy-pasting.

Remote Diff Preview#

When you click Connect GitHub or Push to GitHub:

1. MonoForge queries the GitHub REST API (GET /repos/{owner}/{repo}/contents/README.md).
2. It retrieves the current live markdown file from your repository.
3. It displays an interactive, color-coded side-by-side diff viewer (DiffPreview.tsx) showing:

• Green lines: Additions and newly inserted widgets.
• Red lines: Removals.
• Unchanged lines: Context surrounding the edits.

Executing the Commit#

Once you review the diff:

1. Enter your custom commit message (default: chore: update profile README via MonoForge).
2. Click Confirm & Push.
3. MonoForge sends an authenticated PUT request to GitHub updating the file with SHA integrity checks.
4. Your live GitHub profile updates instantly.