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 in Alloy and Classic projects.
• build-fonts installs custom fonts in Alloy or Classic; TSS class definitions are generated only for Alloy.
• 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
  • Using purgetss.ui in Titanium Classic
  • The play Method
  • The apply Method
  • The open and close Methods
  • The draggable Method
  • Additional Methods
  • Complex UI Elements
  • Available Utilities
  • Implementation Rules
  • Appearance
• Best Practices
  • Appearance Setup
  • Semantic Colors
  • Large Titles on iOS
  • Values and Units
• Grid System

Changelog​

Unreleased​

v7.16.2​

• Custom-font modules expose every processed family. build-fonts --module maps each TTF/OTF to the exact PostScript name Titanium expects, even when the project contains no icon CSS.
• Classic color commands avoid unrelated empty source folders. shades updates only purgetss/config.cjs, while color-module writes the CommonJS file under Resources/lib/ without initializing brand, font, image, or Alloy scaffolding.

v7.16.1​

• Titanium Classic video production assets were added, together with clearer PurgeTSS diagnostics when an automatic Alloy purge fails.

v7.16.0​

• Round non-icon artwork without pre-masking app icons. brand.artworkCornerRadius, piece overrides, and six one-run flags cover the 28 legacy splash PNGs, Feature Graphic, and LaunchLogo. Store/launcher icons stay square for platform masking, and existing projects retain byte-compatible output at the 0% default.
• appicon.padding now has a matching CLI flag. The canonical config exposes its 10% default and --appicon-padding handles temporary changes.

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