Feature

Turn your GitHub repos into a portfolio

Enter your GitHub username, tick the repos worth showing and they become projects on your page, with your GitHub photo and bio filled in. About a minute, start to finish.

How the import works

  1. In the editor, open the import and choose GitHub. If you signed in with GitHub, your username is already there.
  2. makerhandle reads your public profile and up to 100 public repos you own, sorted by stars, then by the most recently pushed. The best few start ticked; forks and archived repos wait behind a button.
  3. Change the ticks as you like. Each repo becomes a project: its homepage when the repo has one, otherwise the repo itself, with the repo's description. Archived repos come over as On hold.
  4. Your GitHub photo, bio and links fill in wherever your profile is still empty. Nothing you already wrote is overwritten.

Only public data is read, through GitHub's public API. Nothing is saved until you pick, and nothing is ever written to GitHub.

A GitHub profile is great for engineers who will read code. It is less good for everyone else: a recruiter, a customer or an investor sees a contribution graph and six pinned repos with no context. We compare the two in GitHub profile README vs a portfolio.

After the import, each repo is a project with a status, screenshots and its own project page, where you can say what it does, what you built and what came of it. The repo stays linked as the source.

Pick, then polish

Imported projects are a starting point. Good next steps:

  • Keep three to six repos that show different things, rather than all of them.
  • Replace terse descriptions like "CLI for X" with one line a non-engineer understands.
  • Add a screenshot or a short video, and a live demo link if there is one.
  • Mark old work honestly with a status instead of deleting it.

Our guide to what to put in a developer portfolio goes further.

Free for five projects

The GitHub import works on every plan. The free plan holds five projects; if you tick more, you choose which come first. Pro is $20 a year for unlimited projects, all nine templates (developers like Terminal) and a custom domain. Not on GitHub? Import from another link in bio or paste links to what you built with the instant page.

Questions

Can I make a portfolio from my GitHub repos?

Yes. Enter your username, tick the public repos you want, and each becomes a project on your makerhandle page with its own project page.

Does it read private repos?

No. Only your public profile and public repos you own, through GitHub's public API.

Will it overwrite my bio?

No. Your GitHub photo, bio and links only fill fields that are still empty.

Does makerhandle write to my GitHub account?

Never. The import only reads public data.

Import your repos

Free for up to 5 projects. Pro is $20/year.