From 02bfb2735bbf1f99adc9dc31ef558ebbb046f222 Mon Sep 17 00:00:00 2001
From: mikl <mikl@iscg.dev>
Date: Thu, 2 Jul 2026 14:54:19 +0300
Subject: [PATCH] feat: add apps.md, comment out aseprite (compile on first
 build)

---
 docs/apps.md         | 81 ++++++++++++++++++++++++++++++++++++++++++++
 hosts/poppy/apps.nix |  5 +--
 2 files changed, 84 insertions(+), 2 deletions(-)
 create mode 100644 docs/apps.md

diff --git a/docs/apps.md b/docs/apps.md
new file mode 100644
index 0000000..0918b17
--- /dev/null
+++ b/docs/apps.md
@@ -0,0 +1,81 @@
+# apps
+
+приложения, игры, утилиты на poppy.
+
+## brew casks (через `hosts/poppy/apps.nix`)
+
+через Homebrew — для приложений которых **нет** в nixpkgs.
+
+### основные
+- google-chrome, google-drive
+- vscodium (редактор)
+- github (GitHub Desktop)
+- docker-desktop
+- ollama-app (LLM)
+- obsidian (заметки)
+- anki (flashcards)
+- calibre (книги)
+- telegram (мессенджер)
+- element (matrix клиент)
+- maccy (clipboard)
+- mos (mouse smoothing)
+- caffeine (не засыпать)
+- marta (файловый менеджер)
+- lunacy (дизайн)
+- skim (PDF)
+- markedit (markdown)
+
+### VPN
+- amneziavpn
+
+### игры
+- prismlauncher (Minecraft)
+
+## nix пакеты (через `hosts/poppy/apps.nix`)
+
+для GUI приложений которые есть в nixpkgs.
+
+### aseprite
+- **в nixpkgs**, но компилируется с нуля (10-30 мин на M1)
+- `pkgs.aseprite` 1.3.17.2
+- **раскомментировать** в `hosts/poppy/apps.nix` ПОСЛЕ первой полной сборки
+- после первой сборки — кэшируется в `/nix/store/`, больше не компилируется
+- пересоберётся только при:
+  - `nix flake update` (новая версия)
+  - `nix-collect-garbage -d` (удаление кэша)
+
+## ручная установка (НЕ через nix)
+
+### нет в brew/nix
+- **Organic Maps** — App Store или скачать .dmg
+- **Fermata** — скачать с productdev.me
+- **v2rayTun** — App Store
+- **Ledger Wallet** — скачать с ledger.com
+- **PureRef** — нет для aarch64-darwin (только Intel Mac), скачать вручную
+
+### App Store apps (Apple ID помнит)
+- Affinity, Figma, Aseprite (если через Steam)
+- Pages, Numbers, Keynote (Creator Studio)
+- Hollow Knight Silksong (на внешнем SSD)
+- и т.д.
+
+## игры
+
+- **Prism Launcher** (nix) — Minecraft launcher
+- **Hollow Knight Silksong** — на внешнем SSD, **бэкапить файлы**
+- **Terraria, Slay the Spire 2** — Steam (в `~/Applications/`)
+
+## brew cleanup ⚠️
+
+- `homebrew.onActivation.cleanup = "none"` (безопасный)
+- **`"zap"` удалит всё что не в nix config** — опасно
+- перед включением `zap` — проверить что все нужные приложения добавлены
+
+## tasks
+
+- [ ] **uncomment aseprite** после первой полной сборки
+- [ ] установить Organic Maps, Fermata, v2rayTun, Ledger Wallet вручную
+- [ ] бэкап Hollow Knight Silksong файлов
+- [ ] добавить Terraria, Slay the Spire 2 (если нужно)
+- [ ] audit остальных App Store apps
+- [ ] вернуть `cleanup = "zap"` после полной инвентаризации
diff --git a/hosts/poppy/apps.nix b/hosts/poppy/apps.nix
index e67c049..ad63a5a 100644
--- a/hosts/poppy/apps.nix
+++ b/hosts/poppy/apps.nix
@@ -39,8 +39,9 @@
 
   # Nix GUI пакеты (нет в brew)
   # pureref — только x86_64-darwin, не работает на M1
-  # будем ставить руками
+  # aseprite — в nixpkgs, но компилируется с нуля (10-30 мин на M1)
+  #   раскомментировать после первой полной сборки (см. docs/apps.md)
   environment.systemPackages = with pkgs; [
-    aseprite     # пиксельный редактор
+    # aseprite     # пиксельный редактор (uncomment after first build)
   ];
 }