Confession time. I signed up for the free Introduction to Linux course from the Linux Foundation. It's a really good course. It's thorough, it's free, and it covers everything you need.
But a few chapters in, my brain checked out.
Page after page of reading. Then more reading. I'd read about cd and mkdir, nod along, close the tab, and forget all of it by the next morning. If you've read my post on why I stopped watching tutorials and started breaking things, you know this is my weak spot. I don't learn by reading. I learn by doing, breaking and fixing.
So I built the kind of Linux learning experience I actually wanted: short, hands-on, and fun.
👉 Try it here: https://pixel-linux-quest.vercel.app
The Linux Compass, but levelled up
Back in January I built The Linux Compass for the GitHub Copilot CLI Challenge. It was a terminal tool that fought what I called "knowledge decay": you'd look up a command, it explained it, and it saved everything to a study log so you wouldn't forget it.
It helped. But honestly, it still felt like homework.
Pixel Linux Quest is the upgrade. Instead of logging what you learned, you learn it by doing. You read a tiny lesson, then you prove it straight away in a real (pretend) terminal in your browser, then you earn XP and unlock the next topic. All wrapped in a retro pixel art style, because learning should be fun.
What's inside
- A story intro. Pip, a little pixel penguin, tells you how Linux came about, from Unix in 1969 to a student in Helsinki in 1991, in 7 animated pixel scenes.
- Bite-sized lessons. Each level is a tiny lesson, then a quick check. Some are quizzes, most are hands-on terminal tasks.
- A pocket terminal in your browser. Nothing to install. It even has Tab completion and Ctrl+C, like the real thing.
-
A live folder map. Type
mkdir treasureand a folder pops up on a pixel map. Typecd treasureand Pip walks there. This is the part I wish I had when I first learned Linux, because I could never picture where I was. -
Pip explains your mistakes. You still see the real Linux error, but Pip adds a friendly note. Type
cd Treasureand Pip says "Close! Linux cares about capital letters." -
The Break It sandbox 💥 Every beginner wonders what happens if you type
rm -rf /. Now you can find out safely. Fun fact I learned while building this: modern Linux actually refusesrm -rf /with a built-in safety check. You have to try a bit harder to destroy everything. The sandbox shows you both. (There's a secret badge if you manage it.) - A Break Room 🕹️ I get distracted easily, so I added a little pixel arcade with three retro mini games for 5 minute breaks. After 20 minutes of learning, Pip asks if you want a break, then sends you straight back to where you left off.
This is just the beginning
This is an ongoing project, and it's going to keep growing.
Right now the first two sections are live: Linux basics and your first commands (8 levels so far). Over the coming weeks I'll be adding:
- New topics every week: files and permissions, processes, text tools and pipes, and Bash scripting.
- Real-world missions: things like "the website is down, find the error in the logs".
- A challenge at the end of each section that mixes everything you learned.
- More break room games, including a calm one for when you just need to chill.
I'll be sharing updates here as it grows, so follow along if you want to see where it goes.
How I built it
I treated it like a real product, not a weekend hack:
- Design first. I started with a mockup of the screens and a written brief with the rules: the colours, the fonts, the lesson format, and "every Linux fact must be correct".
- Small phases. I built it in stages and tested each one before moving on.
- Saying no. The first intro scenes were just coloured boxes. I hated them, so they got redone in proper pixel art.
- Fact checking. A learning site that teaches wrong things is worse than no site, so every lesson gets checked against how real Linux behaves.
The stack: React, Vite and TypeScript. The terminal is a small Linux-like shell written in TypeScript with a pretend filesystem. There are 322 automated tests, GitHub Actions runs the tests and the build on every push, and it's hosted on Vercel.
The DevOps student in me is very happy about that CI pipeline. 😅
I need your help
This is the first version, and I want real feedback to shape what comes next.
- Try the first two sections and tell me where you got stuck, bored or confused.
- Try to break Linux in the sandbox and post your SYSTEM DESTROYED screenshot in the comments.
- Spot a wrong fact? Please tell me. I'd rather be corrected than teach something wrong.
It's open source, so you can also contribute: new lessons, new break room games, fixes, anything.
⭐ GitHub: https://github.com/Maame-codes/pixel-linux-quest
If you're learning Linux too, or you got bored of your course like I did, give it a go and let me know what you think. 🐧
Curriculum topics inspired by the free Introduction to Linux (LFS101) course. Not affiliated with or endorsed by the Linux Foundation.
Top comments (0)