Ghost GitHub Portfolio

npm CI License Docker Pulls codecov

Keep a Ghost portfolio page in step with your GitHub repositories.

`ghost-github-portfolio` reads your public GitHub repositories, keeps the most starred ones, and writes them to a Ghost page as a grid of cards through the Ghost Admin API. Run it as a CLI, in Docker, or as a GitHub Action on a schedule, and the page follows your star counts.

Portfolio page preview

## Features - One Ghost html card with its own scoped style: an intro, a card per repository, and a line pointing at your GitHub profile. - Each card has the repository banner (or a name tile), the name and star count, one line on what it does, and a "Site" link. - Three columns on desktop, two on tablets, one on phones; wide cards on Alto, Source and Casper. - Filters by stars, forks, archived, name patterns and awesome lists, then cuts to `maxRepos`. - Per-repo overrides in `config.yml` or in a `.ghost-portfolio.yml` inside each repository. - Checks that each SVG banner is self-contained, and warns when it falls back to a name tile. - Can write through the Ghost origin when a firewall blocks `