Automated frontend build tool with minification, obfuscation, and protection features. CLI and API support.

📝 Features ✅ Fully automated build process ✅ Automatic file discovery with exclusions ✅ Single configuration for options and ignore lists ✅ CSS + HTML minification + JS and inline-scripts obfuscation ✅ Built-in client-side protections (via protection.js and protection.css)

---

Quick Start

1. Place your source files in src/ folder (html, css, js, assets).
2. Install dependencies:

   npm install
   

3. Build project:

   npm run build
   

4. Result is in build/ folder.

Usage as npm package

CLI (no installation required)

# Basic usage (uses Makefile)
npx obf-minify-build

# Custom source and output directories
npx obf-minify-build --src src --out dist

# Use Node.js build instead of Makefile
npx obf-minify-build --no-make

# Inline resources (new in v0.0.5)
npx obf-minify-build --inline-all --out dist
npx obf-minify-build --inline-css --inline-js
npx obf-minify-build --skip-obfuscation-for vendor,libs

# Show help
npx obf-minify-build --help

As dependency

1. Install as dev dependency:

   npm install obf-minify-build --save-dev
   

2. Use in your build script:

   const { build } = require('obf-minify-build');
   build({ src: 'src', out: 'build' });
   

Commands

• npm run build — full build
• npm run dev — rebuild on changes
• npm run start — build and start local server
• npm run test — run complete test suite
• npm run test:cli — test CLI help

Requirements

• Node.js >= 18
• Linux/macOS/WSL (cpio, find, make)

---

obf-minify-build (Русский)

Автоматизированный инструмент сборки фронтенда с минификацией, обфускацией и защитами. Поддержка CLI и API.

📝 Особенности ✅ Полностью автоматизированная сборка ✅ Автоматический поиск всех файлов с исключениями ✅ Единое место для настройки опций и игнор-листов ✅ Минификация CSS + HTML + обфускация JS и inline-скриптов ✅ Встроенные клиентские защиты (через protection.js и protection.css)

---

Быстрый старт

1. Поместите исходники в папку src/ (html, css, js, assets).
2. Установите зависимости:

   npm install
   

3. Соберите проект:

   npm run build
   

4. Готовый результат — в папке build/.

Использование как npm-пакет

CLI (без установки)

# Базовое использование (использует Makefile)
npx obf-minify-build

# Пользовательские папки исходников и вывода
npx obf-minify-build --src src --out dist

# Использовать Node.js сборку вместо Makefile
npx obf-minify-build --no-make

# Показать справку
npx obf-minify-build --help

Как зависимость

1. Установите как dev-зависимость:

   npm install obf-minify-build --save-dev
   

2. Используйте в build-скрипте:

   const { build } = require('obf-minify-build');
   build({ src: 'src', out: 'build' });
   

Команды

• npm run build — полная сборка
• npm run dev — пересборка при изменениях
• npm run start — сборка и запуск локального сервера
• npm run test — запуск полного набора тестов
• npm run test:cli — тест CLI справки

Требования

• Node.js >= 18
• Linux/macOS/WSL (cpio, find, make)

---

Documentation and API — see docs/ or source code.

Documentation

• API Reference - Complete API documentation
• Examples - Usage examples and best practices
• Testing - Complete testing guide
• Troubleshooting - Common issues and solutions