Migrate from shields.io
Paste a GitHub repo URL and we'll scan the README for shields.io badges, show you a side-by-side preview, and open a PR with shieldcn replacements — all in one click.
Paste your repo
Enter a GitHub repository URL or owner/repo slug.
Preview changes
See each badge side-by-side. Toggle individual badges on or off.
Open the PR
One click creates a PR on your repo. Review and merge when ready.
Paste a GitHub repository URL. We'll scan the README for shields.io badges and show you a preview of the migration.
FAQ
What permissions does the GitHub App need?
Only contents (read/write) and pull requests (read/write) on the repo you select. We never access private repos unless you explicitly install the App on one.
What badges can be migrated?
Every badge provider shieldcn supports — npm, GitHub, GitLab, PyPI, crates.io, Docker, Discord, Codecov, Coveralls, Bundlephobia, VS Code Marketplace, Open VSX, YouTube, NuGet, Packagist, RubyGems, Homebrew, Maven, CocoaPods, pub.dev, Conda, Chrome Web Store, Firefox Add-ons, Chocolatey, Flathub, Snapcraft, F-Droid, jsDelivr, Modrinth, Open Collective, Liberapay, SonarQube, Stack Exchange, Discourse, Matrix, Mastodon, WakaTime, Weblate, and static badges.
What if a badge can't be mapped?
Unmappable badges are left as-is. The preview will show how many were skipped so you can decide whether to manually convert them.
Can I customize the migrated badges?
Yes! After merging the PR, you can add query params like ?variant=branded, ?theme=blue, or ?mode=light to any badge URL. See the docs for all options.
Can I uninstall the App after?
Absolutely. Once the PR is merged, you can remove the App from your repo at github.com/settings/installations anytime.