Minimaz CLI

About

Minimaz is a minimal, low-dependency static site builder and project initializer focused on speed, simplicity, and clean output. It supports HTML, CSS, JavaScript, and TypeScript (.ts → .js), with optional bundling and minification.

Designed for small static sites, utility tools, prototypes, and teams that want reproducible minimal build systems.

Features

• Initialize projects from templates
• Save, list, delete, and update global templates
• Compile TypeScript before minification
• Minify HTML, CSS, JS, and compiled TS
• Optional CSS and JS bundling
• Include external styles/scripts (relative, absolute, node_modules)
• Configurable via minimaz.config.json
• Path replacement support for asset links
• Optional npm initialization
• Optional Git repository initialization
• Git provider / remote URL support
• Interactive prompts with 60s timeout
• Alias support: minimaz or mz
• Lightweight and fast

Installation

Run directly using npx (no global install required):

npx minimaz init my-site
cd my-site
npx minimaz build
npx minimaz version

Using alias:

npx mz i my-site
npx mz b
npx mz v

Project Structure

my-site/
├── dist/              # Output folder (generated)
├── public/            # Static assets
├── src/               # HTML, CSS, JS, TS files
├── minimaz.config.json
├── package.json       # Optional (if npm init used)
├── .gitignore
└── ...

Configuration

{
    "src": "src",
    "dist": "dist",
    "public": "public",
    "bundling": {
        "css": true,
        "js": true
    },
    "minify": {
        "html": true,
        "css": true,
        "js": true,
        "ts": true
    },
    "replace": {
        "/public/": "public/"
    },
    "styles": [
       "../node_modules/library.css"
    ],
    "scripts": [
        "../node_modules/library.js"
    ],
    "folders": {
        "public": "public",
        "src": ""
    }
}

• bundling.css/js → concatenate files
• minify.html/css/js/ts → toggle per file type
• styles/scripts → include external files
• replace → asset path replacements
• styles & scripts → external styles or scrips to add
• folders → folders to scan

Commands

# Build
minimaz build
mz b

# Clear
minimaz clear
mz c

# Init
minimaz init <project-name>
minimaz init <project-name> --template <name>
minimaz init <project-name> --npm
minimaz init <project-name> --git --gitprovider github
mz i my-site -t template

# Help
minimaz help
minimaz help build
mz h build

# Template management
minimaz template <path>
minimaz template --list
minimaz template --delete <name>
minimaz template --update <name>
minimaz template --update

# Version
minimaz version
mz v

Upcoming & Future Features

Planned improvements and roadmap direction. Scope is intentionally controlled to preserve simplicity.

npm install -g @minimaz/cli

minimaz template <repo-url>

minimaz convert input.jpg --to webp

minimaz analyze

<block src="header.html"></block>

Global Templates

~/.minimaz/templates

Use templates to initialize consistent projects across environments.

License

MIT License

Links

• GitHub Repository
• npm Package