Home

3 Creative Uses for GitHub Issues

While GitHub’s primary offering is to host remote Git repositories, the features it has provided to support this offering open the door for non-traditional uses that can boost your productivity and perhaps save you from using additional services.

As most products mature, they hone in on a particular audience and a core set of features. How we use those products tends to narrow to that product offering.

But there are also a handful of tools out there whose use is more open-ended and can be interpreted and repurposed in many different ways. And I love to take advantage of these situations.

GitHub is Super Flexible

GitHub is one of those tools. Its primary purpose is to host remote Git repositories, which are typically collections of plain text files.

But the real power of GitHub is in the tooling surrounding these repositories. There are features like issues, pull requests, discussions, and projects. But there is also a super powerful API for manipulating repository files and the repo's supporting features.

Creative Uses for GitHub Issues

While there are many creative uses for various GitHub features, I wanted to focus on three very cool interpretations of stretching how issues can be used:

  • Website CMS (Blog Posts)
  • Comments
  • Image Host

Using GitHub Issues for Blog Post Content

It's kind of wild idea, but you could actually use GitHub issues as a CMS! swyx explains how he moved to a GitHub CMS in this post (which is a GitHub issue).

swyx calls attention to GitHub API's rate limiting, which is an important consideration if you're going to seriously consider this. But prerendering can help in this case.

Building a Comment System with GitHub Issues

You may have noticed that the swyx issue also has comments that appear as commentary for that particular post. That's because they are!

Comments on swyx blog post

GitHub issues can also be used as a commenting system. In fact, I'd be much more likely to use them as comments on posts, as they are already designed to be a commenting thread, with built-in reactions.

utterances is a widget that is built to help you employ this solution for your site. Check it out!

GitHub as Your Site's Image Host

Perhaps the oddest of the bunch, you can also host images using GitHub issues. In Method #3 of my 3 Ways to Add an Image to a GitHub README, I demonstrate that uploading an image to an issue results in a URL from GitHub's CDN that can be safely used on your site.

Upload Image to GitHub Issue

Note that this may not be the most optimal solution, given that you would be loading images at full size. And I haven't yet implemented this. But, in theory, it could work. It's something to consider, for sure.


I'm sure there are many more creative uses for various GitHub features (including issues), but I hope this opens the door to dream bigger. And if you can realize some of these uses, you may even be able to eliminate the need for some specific tool or service you're using today.

Let's Connect

Keep Reading

3 Ways to Add an Image to GitHub README

Images often come in handy alongside documentation. Here are a few methods for adding them to your README and other markdown files.

Jan 30, 2021

Deploying a Static API to Vercel

A super simple example of building a static API that walks through the deploy process using Vercel Now. It's part of a series of tutorials on building and deploying static APIs.

Apr 17, 2020

Building a Static API with Node.js

Learn how to build a static API with Node.js. We'll write a node build script that converts local YAML files into a set of structured JSON output files.

Apr 09, 2020