What it does:

• 23,300+ utility classes for colors, spacing, typography, layout, and more.
• Parses your XML files and writes an app.tss with only the classes you actually use.
• Customizable via config.cjs. Supports arbitrary values for one-off sizes and colors.
• Icon fonts: Font Awesome, Material Icons, Material Symbols, and Framework7-Icons in Buttons and Labels.
• 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: 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
• Customization
  • The Config File
  • Custom Rules
  • The apply Directive
  • The opacity Modifier
  • Arbitrary Values
  • Platform and Device Modifiers
  • 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
• Recommendations
  • Window Defaults
  • Semantic Colors
  • Appearance Setup
• Grid System

Changelog​

v7.5.3​

• Appearance module — new Appearance export for Light/Dark/System mode switching with persistence. Methods: init(), set(mode), get(), toggle(). See Appearance Setup
• Default font family classes — font-sans, font-serif, and font-mono generated automatically with platform-appropriate values
• XML validation — detects illegal -- inside XML comments during pre-validation

v7.5.0​

• extend support for Window, View, and ImageView — customize component defaults from theme.extend in config.cjs
• Shorthand apply — { apply: '...' } is automatically normalized, so the default: wrapper is optional
• Property deduplication — applied values win over static defaults instead of duplicating
• Automatic platform resolution — classes inside ios:/android: blocks find their platform-specific version automatically
• Font Awesome 7.2.0
• Fixed: extend.Window silently ignored, duplicate font properties, array-type properties missing [ ] notation

v7.4.0​

Animation module expansion. 9 new methods bring the module to 15 total:

• transition, pulse, sequence, swap, shake, snapTo, reorder, undraggable, detectCollisions
• New utility classes: snap-back, snap-center, snap-magnet, keep-z-index
• Delta-based drag for transformed views, position normalization, property inheritance from the Animation object

See the UI Module documentation for full details.

v7.3.0​

• BREAKING: tailwind.tss → utilities.tss — renamed to reflect PurgeTSS's identity as a standalone toolkit
• XML syntax validation — pre-validation for Alloy XML files with line numbers and fix suggestions
• Classic Titanium compatibility — deviceInfo() works without Alloy dependencies

v7.2.7​

• Security fixes — command injection in glob, prototype pollution in js-yaml
• Dependency cleanup — reduces installation size by ~45MB, removed unused packages
• Titanium SDK 13.1.0.GA — new utility classes for navBarColor, forceBottomPosition, multipleWindows

v7.2.6​

• Updated Font Awesome to version 7.1.0
• Simplified flag property names in utilities.tss