From b75801ffdc89448ee5fdd7c5cc73d7689f34c29d Mon Sep 17 00:00:00 2001
From: erjemin <erjemin@gmail.com>
Date: Thu, 13 Aug 2026 19:12:46 +0300
Subject: [PATCH] =?UTF-8?q?add:=20=D0=9E=D0=BF=D0=B8=D1=81=D0=B0=D0=BD?=
 =?UTF-8?q?=D0=B8=D0=B5=20npm-=D1=81=D0=B1=D0=BE=D1=80=D0=BA=D0=B8=20?=
 =?UTF-8?q?=D0=BF=D0=B0=D0=BA=D0=B5=D1=82=D0=BE=D0=B2=20=D1=81=D1=82=D0=B0?=
 =?UTF-8?q?=D1=82=D0=B8=D0=BA=D0=B8=20(alpine,=20htmx,=20tailwind)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend-assembly/README.md | 67 +++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 frontend-assembly/README.md

diff --git a/frontend-assembly/README.md b/frontend-assembly/README.md
new file mode 100644
index 0000000..f6c679b
--- /dev/null
+++ b/frontend-assembly/README.md
@@ -0,0 +1,67 @@
+# frontend-assembly
+
+Эта папка отвечает за сборку всех фронтенд-зависимостей проекта HYPN0.
+Каждый подкаталог — отдельный инструмент, который собирается в готовый бандл/статик.
+
+## Что здесь лежит
+
+### `tailwind/` — сборка Tailwind CSS v3.4
+
+```
+tailwind/
+├── package.json          # Зависимости: tailwindcss@3.4, postcss, autoprefixer
+├── package-lock.json     # Фиксация версий
+└── build-tailwind.sh     # ← запускается из корня проекта
+```
+
+**Что делает:**
+- `build-tailwind.sh` создаёт временные файлы (`tailwind.config.js`, `postcss.config.js`, `input.css`),
+  запускает `npm ci` + `npm run build`, собирает `public/static/css/tailwind.min.css`,
+  затем удаляет временные файлы.
+- Результат: `public/static/css/tailwind.min.css` — минифицированный CSS со всеми
+  используемыми утилитами + кастомные стили из `hypn0/templates/css/tailwind-custom.css`.
+
+### `htmx/` — сборка htmx
+
+```
+htmx/
+├── package.json
+└── package-lock.json
+```
+
+### `alpine/` — сборка Alpine.js
+
+```
+alpine/
+├── package.json
+└── package-lock.json
+```
+
+## Как запускать сборки
+
+Из корня проекта:
+
+```bash
+# Tailwind CSS
+bash scripts/build-tailwind.sh
+
+# htmx
+bash scripts/build-htmx.sh
+
+# Alpine.js
+bash scripts/build-alpine.sh
+```
+
+Каждый скрипт сам делает всё:
+1. проверяет наличие `npm`;
+2. создаёт временные файлы;
+3. устанавливает зависимости через `npm ci`;
+4. запускает `npm run build`;
+5. кладёт готовый бандл в `public/static/...`;
+6. удаляет временные файлы.
+
+В рабочем дереве не остаётся мусора от сборки.
+
+## Кодовая статика
+
+В будущем — возможно, сборка CodeMirror 6 для админки Django.