From a23a1609de4c063a823671fb7079b7d2deb0675e Mon Sep 17 00:00:00 2001
From: Raghuram Subramani <raghus2247@gmail.com>
Date: Sat, 2 Aug 2025 10:35:20 +0530
Subject: projects: hydrate pages with README and add page structure

---
 projects/bubbl.md | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

(limited to 'projects/bubbl.md')

diff --git a/projects/bubbl.md b/projects/bubbl.md
index 26b794c..d9d9947 100644
--- a/projects/bubbl.md
+++ b/projects/bubbl.md
@@ -3,10 +3,24 @@ description = An Operating System for The x86 Architecture.
 languages = C / C++ / ASM
 url = /projects/bubbl
 template = project.html
+link = https://github.com/compromyse/bubbl
+linklabel = SOURCE
 ---
 
-# BUBBL
+## Building
 
-```py
-import time
+#### Dependencies: Nix with flakes enabled and (optionally) direnv
+
+After entering the devshell (with direnv or `nix develop`),
+
+```sh
+mkdir build && cd build
+cmake -G Ninja ..
+ninja
+```
+
+## Running
+
+```sh
+ninja run # or run-headless or run-gdb
 ```
-- 
cgit v1.2.3