hyperbuild

A fast one-pass in-place HTML minifier written in C with advanced whitespace handling.

Currently in beta, working on documentation and tests. Issues and pull requests welcome!

Features

• Minification is done in one pass with no backtracking or DOM/AST building.
• No dynamic memory is allocated during processing, which increases safety and performance.
• Advanced whitespace handling options allow maximum minification while retaining valid spaces.

Usage

This is the library. To use hyperbuild, you'll probably need one of these:

• hyperbuild CLI

Documentation for the library itself is currently WIP.

hyperbuild uses the following dependencies, which are included as submodules:

• nicehash

Minification

Guide below is currently WIP.

Whitespace

hyperbuild has advanced whitespace minification that can allow strategies such as:

• leave whitespace untouched in pre and code, which are whitespace sensitive
• trim and collapse whitespace in content tags, as whitespace is collapsed anyway when rendered
• remove whitespace in layout tags, which allows the use of inline layouts while keeping formatted code

Beginning and end

<p>↵
··The·quick·brown·fox↵
</p>

Between text and tags

<p>The·quick·brown·fox·<strong>jumps</strong>·over·the·lazy·dog.</p>

Contiguous

<select>↵
··<option>Jan:·········1</option>↵
··<option>Feb:········10</option>↵
··<option>Mar:·······100</option>↵
··<option>Apr:······1000</option>↵
··<option>May:·····10000</option>↵
··<option>Jun:····100000</option>↵
</select>

Whole text

<p>↵
···↵
</p>

Tag classification

Type	Content
Formatting tags	Text nodes
Content tags	Formatting tags, text nodes
Layout tags	Layout tags, content tags
Content-first tags	Content of content tags or layout tags (but not both)

Specific tags

Tags not in one of the categories below are specific tags.

Formatting tags

<strong> moat </strong>

Content tags

<p>Some <strong>content</strong></p>

Content-first tags

<li>Anthony</li>

<li>
  <div>
  </div>
</li>

Layout tags

<div>
  <div></div>
</div>

Development

Currently, hyperbuild has a few limitations:

• Only UTF-8 is supported.
• Not aware of exotic Unicode whitespace characters.
• Follows HTML5 only.
• Only works on Linux.

Patches to change any of these welcome!