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
  • 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.15.0​

• Standalone resource commands now work cleanly in Classic Titanium projects. images, semantic, shades, color-module, module, icon-library, and build-fonts detect Alloy or Classic and write to native Resources/ paths where appropriate. Classic does not receive the PurgeTSS utility-class lifecycle.
• Official icon modules expose font-family aliases. For example, use fontAwesome.icons.home with fontAwesome.solid; families exposes the complete stable mapping for every bundled library.
• images follows tiapp.xml deployment targets by default. Explicit --android and --ios flags remain available when you need an override.

v7.14.0​

• Square iOS/store artwork is now full-bleed by default. icon, dark, tinted and marketplace use 0% instead of the former 4% inset. --ios-padding still moves the family together when the source is a logo that needs breathing room.
• DefaultIcon.png and DefaultIcon-ios.png now both obey brand.icon.padding. The root fallback had incorrectly inherited Android adaptive padding, creating a much larger border than configured. Both outputs are opaque and use the same inset.
• Standalone Classic projects get a complete first-run setup. If purgetss/config.cjs is missing, brand creates the canonical config. A positional source such as sample-icon.png is adopted as purgetss/brand/logo.png when no canonical logo exists, and the move is reported.
• Generation follows tiapp.xml deployment targets in Alloy and Classic. Normal runs omit disabled platforms; explicit --only remains an override. Classic Android retains the 11 Resources/android/images/res-* splash variants Titanium consumes even though ti create does not seed those folders.
• Visible icon frames are diagnosed before they surprise you. Opaque edge-to-edge artwork combined with padding and a contrasting inherited background produces a warning naming the affected pieces. White remains a configurable fallback, not a platform requirement.

v7.13.2​

• purgetss brand --help advertised padding defaults the command does not use: 19 for the adaptive icon and 20 for both splash sets, where the pipeline applies 18, 26 and 26. The seven padding descriptions are now interpolated from the piece table instead of being hand-typed in a second place, with a new test that compares the real --help output against that table. The values documented on this site were already the correct ones.

v7.13.1​

• Four vulnerable transitive dependencies patched, all of which shipped inside v7.13.0: postcss, nanoid, brace-expansion and uuid. Patch bumps within the same major, so package.json is untouched and only the lockfile moves. npm audit reports zero vulnerabilities afterwards.

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