2026-hypn0-site/frontend-assembly/README.md

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

Как запускать сборки

Из корня проекта:

# 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.