diff --git a/README.md b/README.md
index 8be02d0..d64455e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,58 @@
 # Fenris-xbps
 
-XBPS distribution repository for Fenris
\ No newline at end of file
+XBPS distribution repository for Fenris.
+
+## Repository Structure
+
+```
+stable/
+  x86_64/
+    fenris-<version>_1.x86_64.xbps      # Package files
+    fenris-<version>_1.x86_64.xbps.sig2  # Package signatures
+    x86_64-repodata                       # Repository index
+    x86_64-repodata.sig2                  # Repository index signature
+  keys/
+    fenris-xbps-signing.pub               # Public signing key
+```
+
+## Usage
+
+### Adding the repository
+
+```sh
+# Import the signing key
+sudo xbps-install -S https://git.bongbetic.com/xavierk/Fenris-xbps/raw/branch/stable/x86_64
+```
+
+Or manually add to `/etc/xbps.d/xbps.conf`:
+
+```
+repository=https://git.bongbetic.com/xavierk/Fenris-xbps/raw/branch/stable/x86_64
+```
+
+### Installing Fenris
+
+```sh
+sudo xbps-install -S fenris
+```
+
+### Updating Fenris
+
+```sh
+sudo xbps-install -Su fenris
+```
+
+## Signing
+
+Packages and repository metadata are signed with the Fenris XBPS signing key.
+The public key is available at `keys/fenris-xbps-signing.pub`.
+
+## Publication Mechanism
+
+1. Build the XBPS package using `xbps-create`
+2. Sign the package: `xbps-rindex --sign-pkg --privkey <key> <package>.xbps`
+3. Add to index: `xbps-rindex --add <repo-dir>/<package>.xbps`
+4. Sign the repository: `xbps-rindex --sign --privkey <key> --signedby "Fenris Packaging <packaging@bongbetic.com>" <repo-dir>`
+5. Commit and push to `stable` branch
+
+Raw URLs serve artifacts immediately without LFS indirection.
diff --git a/keys/fenris-xbps-signing.pub b/keys/fenris-xbps-signing.pub
new file mode 100644
index 0000000..0ef50ef
--- /dev/null
+++ b/keys/fenris-xbps-signing.pub
@@ -0,0 +1 @@
+ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCeyPf57a/1RUWi0Ja/oG2mJEMZTWp1smtzDVgXLxjllI7Z0et0MAJk8D0QqyOY/dNgtUfwkJ/MFKvnEfkjxUB1FT3o0g0VBqgPdQGXIHtHRFxqaLsxl0gZa1uyL9ju/4Uvq4evlS+tdulST1oTJ3nV9iauc7cM4PZCXHsV5a05D8RtZY4Wo72sa/nfznXE0z9ii9ObVUAJslINN2JQCMlSuN98zakbVqPQbSJk/dCajNKcLmn5H51Ztzkf966ct05qISs2/FgZpaVwNHKWeiDb7w9u4pJldbvu1AgdbZzCJCybPn4xcbklS3MnYd4YHAJJXcc24hoXzcozZdQ/Kc6/bNaTVBpovjafTa3EKhymxN8fimXBaGn21X0mc1nVeW4l15gmx3W1ENnhq9dIa6IeKUMSib9cKVqWvoeLtNsgnwklc4efccyvAX//FmWMis9Dv+qU9kEJmvgWnU50iiqo07qd8BY1nsuUl0BAZmKbFO7KuZ70yG7+6pNyHy1bGMs= fenris-xbps-signing@bongbetic.com
diff --git a/x86_64/fenris-0.3.5_1.x86_64.xbps b/x86_64/fenris-0.3.5_1.x86_64.xbps
new file mode 100644
index 0000000..484b4ba
Binary files /dev/null and b/x86_64/fenris-0.3.5_1.x86_64.xbps differ
diff --git a/x86_64/fenris-0.3.5_1.x86_64.xbps.sig2 b/x86_64/fenris-0.3.5_1.x86_64.xbps.sig2
new file mode 100644
index 0000000..604cea2
Binary files /dev/null and b/x86_64/fenris-0.3.5_1.x86_64.xbps.sig2 differ
diff --git a/x86_64/fenris-0.3.6_1.x86_64.xbps b/x86_64/fenris-0.3.6_1.x86_64.xbps
new file mode 100644
index 0000000..c0112bc
Binary files /dev/null and b/x86_64/fenris-0.3.6_1.x86_64.xbps differ
diff --git a/x86_64/fenris-0.3.6_1.x86_64.xbps.sig2 b/x86_64/fenris-0.3.6_1.x86_64.xbps.sig2
new file mode 100644
index 0000000..3c7133d
Binary files /dev/null and b/x86_64/fenris-0.3.6_1.x86_64.xbps.sig2 differ
diff --git a/x86_64/x86_64-repodata b/x86_64/x86_64-repodata
new file mode 100644
index 0000000..7d8f142
Binary files /dev/null and b/x86_64/x86_64-repodata differ