diff --git a/content/projects/debrepo.md b/content/projects/debrepo.md
index ed97968..6bbb867 100644
--- a/content/projects/debrepo.md
+++ b/content/projects/debrepo.md
@@ -1,18 +1,39 @@
 +++
 title = "Debrepo"
 date = 2023-05-01
-description = "A Debian repository management tool"
+description = "Lightweight tool to create and manage Debian APT repositories"
 
 [extra]
 state = "stable"
 +++
 
-# Debrepo
-A Debian repository management tool.
+**Debrepo** is a lightweight tool for creating and managing Debian repositories for `*.deb` packages — a simple alternative to heavier tools like `reprepro` or `aptly`.
 
-## About
-`Debrepo` is a software tool designed for creating and managing Debian repositories for `*.deb` packages, providing a lightweight and user-friendly alternative to more complex tools like `reprepo` or `aptly`. While these alternatives may offer more advanced features, Debrepo focuses on providing essential functionality and ease of use for repository management, allowing users to easily add, remove, and update packages within their repositories. With Debrepo, users can efficiently manage their Debian repositories without the unnecessary complexity of more advanced tools.
+#### **Key Features:**
+* **Init repository structure** (`debrepo init`)
+* **Add / delete packages** (`debrepo add`, `debrepo del`)
+* **List packages** (`debrepo list`)
+* **Built-in static serving** for quick testing (`debrepo serve`)
+* **Minimal deps:** `sh`, `dpkg`, `gpg`, `python3`
 
-## Links
-- [Git](https://git.filiprojek.cz/fr/debrepo)
+#### **Quick usage**
+```bash
+# create repo structure
+debrepo init /path/to/repo
+
+# add a package
+debrepo add ./build/foo_1.0_amd64.deb
+
+# list & remove
+debrepo list
+debrepo del foo_1.0_amd64
+
+# serve locally (for testing)
+debrepo serve
+````
+
+Find the source here:
+
+* Primary (Gitea): [https://git.filiprojek.cz/fr/debrepo](https://git.filiprojek.cz/fr/debrepo)
+* GitHub (mirror): [https://github.com/filiprojek/debrepo](https://github.com/filiprojek/debrepo)