GitHub readme + Dungeons & Dragons

Roll For Initiative!

Table of Contents


Like many of my stories, I saw a post on Reddit showcasing a special ‘hidden’ feature that GitHub had added to their users’ repository list - the ability to make a personal readme that displays on the front page of your GitHub.

Check out some awesome examples here!

The Theoretical

There isn’t much to say. I’m super into Dungeons and Dragons (DND, D&D) and decided I’d make my profile page a Initiative Roller. If you aren’t familiar with D&D, whenever combat starts in the game for the first time, everyone engaged in the fight “rolls for initiative”. All participants, friend or foe, roll a 20-sided dice (D20) to determine who takes the first turn. Depending on your class, race, or equipment, you may add or subtract from this number.

I followed the examples I linked above as well as the GitHub documentation.

The Practical

You can view my creation here.

I used JavaScript backed with some node module libraries to do the heavy lifting. Since I wanted to persist people’s class choices and their roll counts as part of the fun, I implemented text files which act as a database of sorts.

Part of the charm of the personal readme was being able to use Actions, GitHub’s CI/CD workflow. Whenever someone chooses a class on the readme and submits the issue, the following happens inside my Action workflow:

Yes, it’s not the most efficient or beautiful thing - everything being inside one file bugs me a bit - but it was such a short-lived and fun breakable toy that my drive to refactor it is low.

Some Notes

Check out the GitHub Actions pages and write your own!

I’m a web developer who focuses mostly in the .NET stack. When not playing hard I enjoy reading, building computers, and spending time with my family.

comments powered by Disqus