What it does:

• 23,300+ utility classes for colors, spacing, typography, layout, and more.
• Parses XML files and writes an app.tss with only the classes you use.
• Customizable through config.cjs, with arbitrary values for one-off sizes and colors.
• Icon fonts for Buttons and Labels: Font Awesome, Material Icons, Material Symbols, and Framework7-Icons.
• build-fonts command generates fonts.tss with class definitions and fontFamily selectors for any font you drop in.
• shades command generates color palettes from a hex value.
• Animation module with 2D transforms, draggable views with collision detection, sequential animations, and position utilities.
• Grid system for aligning and distributing elements in rows and columns.

Table of Contents​

• Installation
• Commands
• App Assets
  • App icons and branding
  • Multi-density images
• Customization
  • The Config File
  • Custom Rules
  • The apply Directive
  • The opacity Modifier
  • Arbitrary Values
  • Platform and Device Modifiers
  • Custom Fonts
  • Icon Fonts Libraries
• The UI Module
  • Introduction
  • The play Method
  • The apply Method
  • The open and close Methods
  • The draggable Method
  • Complex UI Elements
  • Additional Methods
  • Available Utilities
  • Implementation Rules
  • Appearance
• Best Practices
  • Appearance Setup
  • Semantic Colors
  • Large Titles on iOS
  • Values and Units
• Grid System

Changelog​

v7.11.1​

• Fixes for the SVG image pipeline from v7.11.0: width/height now cascade symmetrically (the unpinned side derives from the viewBox on every run instead of getting cemented in config.cjs), syncConfigImages mirrors the current run so shrinking a class actually shrinks the entry, and SVGs listed in images.files always emit PNG to match Titanium's runtime fallback.
• purgetss images respects --yes for overwrite confirmations, and syncConfigImages no longer bumps config.cjs mtime on untouched runs (which was triggering needless utilities.tss rebuilds).
• Restored src/dev/builders/tailwind-builder.js — it was the entry point for npm run build:tailwind, deleted as "orphan" by mistake in 7.11.0.

v7.11.0​

• SVG-aware compile-time image pipeline as a post-step of purgetss. When views or controllers reference image="/images/<sub>/<name>.svg" alongside utility classes that resolve to numeric width/height (w-32, w-(300), h-auto, …), purge now compiles those SVGs into the 8 Titanium density variants (5 Android + 3 iPhone PNGs) using dimensions resolved from app.tss. Titanium loads the generated .png automatically at runtime; the SVG attribute in your source is never rewritten. See SVG-aware image pipeline.
• New images.files array in config.cjs to pin width/height per file, plus images.autoSync (default true) for devs who want to manage images.files by hand.
• config.cjs syntax validator: type mismatches in known fields (theme.fontFamily.*, theme.extend.fontFamily.*) print a formatted Config Syntax Error block with file, JSON path, and a fix snippet — instead of cryptic downstream crashes like rule.startsWith is not a function.

v7.10.2​

• Configs written before v7.7.0 (the brand: regroup) now auto-migrate in memory on every run. The legacy flat layout used to crash auto-purge with TypeError: Cannot create property 'ios' on number '15'; getConfigFile() now normalizes them to the grouped layout before applying defaults. See Upgrading from pre-7.7.0 configs.
• Internal fix: logger.warning and logger.success are now defined — the ~40 callsites across brand, images, cleanup-legacy, and svg-utils no longer throw TypeError: logger.warning is not a function when those opt-in commands run.

→ See the full changelog for older releases (v7.10.1 and earlier).