Skip to content

Open source · Runs in your browser

Frame the repo.Share the card.

Repo Frame turns a public GitHub repository into a social card worth putting on a timeline. Choose a template, tune it, export it. Nothing leaves your browser.

No account · No upload · Public repositories only

Template Minimal · 1:1 · PNG

001 / 006Overview

What it reads

A card is only as good as the data behind it.

Paste a URL and every field on the card is read straight from the repository itself. Nothing leaves your device.

Name, description, topics
Always
Stars, forks, watchers
Always
Open issues, pull requests
On request
Language split
On request
Contributors
On request
Latest release
On request
Licence
Always

002 / 006What it reads

The workbench

Check how your repository card look.

Template Cover · Palette Default

Card colour preset

Try a palette

Five cards out of many, see all the templates

003 / 006The workbench

Local first

There is no server to trust, because there is no server.

Accounts
None
Uploads
None
Storage
Your browser

004 / 006Local first

FAQ

Your questions answered.

Everything you need to know about Repo Frame: how repository data is read, what the templates and exports can do, and how your work stays on your device.

General & Overview

How does Repo Frame fetch repository data?

Your browser calls GitHub's public REST API directly, with no server in between. Paste a repository URL or an owner/repo shorthand. The name, description, topics, stars, forks, watchers and licence are read up front; the language split, contributors, open issues, pull requests and latest release are read only when a template asks for them. Responses are cached in your browser for 30 minutes.

Do I need a GitHub account or API token?

No. Repo Frame only reads what GitHub already publishes, so there is nothing to sign in to and no token to paste. GitHub does limit how often it answers one address: 60 requests an hour. Your browser keeps each repository for 30 minutes before asking again, which holds normal editing well inside that, and if you reach the limit anyway Repo Frame tells you when it resets.

Does Repo Frame support private repositories?

No. Repo Frame works with public repositories only. It reads a repository the same way any visitor without access does, so a private one comes back as not found.

Templates & Customization

What templates and export formats are supported?

This build ships 26 templates, among them Minimal, Split, Bento, Release, Cover, Terminal, Almanac, Gauge and Marquee. Each renders in four aspect ratios: 16:9 (1200×675), 1:1, 4:5 and 9:16. Cards export as PNG, and as WebP or JPEG where your browser supports them, at 0.5× to 4× scale, so a 16:9 card can leave at 4800×2700.

Can I customize colors, fonts, and visible metrics?

Yes. Every template carries its own palettes as chips you apply in one click, among them Slate, Carbon, Cobalt, Signal and Acid, and every colour can be set by hand instead. The settings panel also controls the typeface, which metrics appear (stars, forks, language split, contributors, licence, latest release, topics), and layout details such as spacing, radius and border weight. Each template declares its own controls, so the panel changes with the template.

How do I set the exported card as my repository's social preview image?

Export the card as a PNG, then open your repository on GitHub and go to Settings → General → Social preview to upload it. You can also commit it to the repository (say, .github/assets/og-card.png) and feature it in your README.

Privacy & Open Source

Is any data stored or uploaded to external servers?

None. There is no backend, no database, no analytics and no upload. GitHub is the only host your browser talks to, and it is your browser that talks to it. Everything you make stays on your device: projects and cached repository data in IndexedDB, small preferences such as theme and aspect ratio in localStorage.

Is Repo Frame free and open source?

Yes. Repo Frame is free and open source under the Apache License 2.0, built by Orbits Lab. Read the source, host your own instance, or contribute a template on GitHub.

Still have questions?

Can't find the answer you're looking for? Reach out to the Orbits Lab team or open an issue on GitHub.

Ask on GitHub

005 / 006FAQ

006 / 006Help it spread