Initial commit

README.md

@@ -0,0 +1,36 @@
+# Personal APT repository
+
+This directory is a minimal Debian/apt repository that hosts personal
+packages for the Clockwork Pi image.
+
+Currently it contains only **clockworkpi-theme**.
+
+## Structure
+```
+apt-repository/
+├── build-repo.sh               # helper to rebuild the index
+├── pool/main/c/clockworkpi-theme/
+│   └── clockworkpi-theme_*.deb # package files live here
+└── dists/bookworm/stable/main/binary-all/
+    ├── Packages
+    └── Packages.gz
+```
+
+## Usage
+1. Build / rebuild your theme package in *pi-gen* (e.g. via
+   `scripts/package-custom-theme.sh`).
+2. Run the helper here:
+   ```bash
+   cd apt-repository
+   ./build-repo.sh
+   ```
+3. Commit & push this repo – the raw URL of the repo root is the apt
+   source, e.g.
+   ```
+   deb [arch=all] https://gitea.example.com/olivier/apt-repository bookworm stable main
+   ```
+
+## Adding more packages
+Just copy additional `.deb` files into an appropriate sub-directory
+under `pool/` (follow the first letter scheme) and run
+`./build-repo.sh` – the script rescans the entire pool each time.