qqqqqf-q · alexma233 · Jun 13, 2026 · Jun 14, 2026 · Jun 14, 2026 · Jun 14, 2026
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -11,6 +11,14 @@ Thank you for considering a contribution to Arkloop. This document covers the pr
 - Docker and Docker Compose
 - PostgreSQL 16+ (or use `docker compose up postgres`)
 
+Alternatively, if you use Nix with flakes enabled, enter the pinned development shell:
+
+```bash
+nix develop
+```
+
+The flake provides Go 1.26, Node.js, Corepack-managed pnpm, Docker Compose, PostgreSQL/Redis clients, and the local CI helper dependencies. Docker still needs a running host daemon.
+
 ### Local Development Setup
 
 ```bash

diff --git a/README.md b/README.md
@@ -39,6 +39,15 @@ Homebrew installs the Arkloop CLI only:
 brew install qqqqqf-q/arkloop/arkloop && ark web
 ```
 
+### Desktop via Nix
+
+Linux users with flakes enabled can run or install the desktop app from the flake:
+
+```bash
+nix run github:qqqqqf-q/Arkloop
+nix profile install github:qqqqqf-q/Arkloop
+```
+
 For a headless Linux machine, use one command:
 
 ```bash

diff --git a/flake.lock b/flake.lock