Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


A Gatsby theme to showcase your open-source projects.

Getting started


Install the theme on any Gatsby site:

# with yarn:
yarn add gatsby-theme-oss
# or with npm:
npm install gatsby-theme-oss


Configure the theme in your gatsby-config.js:

require("dotenv").config(); // configures environment variables for the GitHub token, more on https://gatsby.dev/env-vars

module.exports = {
  plugins: [
      resolve: "gatsby-theme-oss",
      options: {
        title: "Hi, I'm Robin 👋", // your site's title
          "I'm the developer behind gatsby-theme-oss. Check out my other open-source projects below!", // your site's subtitle
        github_username: "robinmetral", // your GitHub username to pull your pinned repos
        github_token: process.env.GITHUB_TOKEN // a GitHub token (with repo access)

You’ll also need an icon in your root directory named icon.png to generate a favicon for your site (the theme uses gatsby-plugin-manifest under the hood).


  • :octocat: Showcases your pinned repos from GitHub
  • :woman_singer: Styled with Emotion
  • :sparkles: Themeable with Theme UI
  • :100: 100/100 Lighthouse scores
© 2023 Gatsby, Inc.