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.18.0​

• Platform and device modifiers stack. ios:tablet:bg-red-500 (in either order) now generates [platform=ios formFactor=tablet]. Alloy reads only the last bracket of a selector, so tablet: on an iOS-only class used to lose its platform condition. A modifier that contradicts the class, such as android:status-bar-dark, leaves a comment in app.tss instead of a selector that never applies. See Combining a platform and a device.
• Font Awesome Pro and Beta work again. purgetss build no longer stops with ENOENT, and icon-library --module / --styles generate fontawesome.js and fontawesome.tss instead of printing a placeholder.
• Stricter flags. icon-library --vendor accepts materialsymbols and rejects unknown values before copying anything. images --width accepts 1 to 1024, the largest value whose xxxhdpi output fits the 4096px cap. See the icon-library command.
• Removed: the *-keyboard-type-appearance* classes (they assigned an appearance constant to keyboardType; use keyboard-appearance-*), snap-magnet (never read by the animation module), and init --all (never implemented). (Npx) arbitrary values are accepted again: w-(100px) means explicit pixels, not a redundant unit.

v7.17.1​

• The notification icon is now named notificationicon.png. firebase.cloudmessaging resolves that exact name, so data messages find the icon without any manifest wiring; under the old ic_stat_notify name they fell back to the opaque launcher icon and the status bar showed a white blob. Projects that wired @drawable/ic_stat_notify by hand update one meta-data line and delete the five stale files.

v7.17.0​

• --dependencies scaffolds an ESLint setup that runs. The template is eslint.config.mjs, a flat config for ESLint 9 that declares the Titanium and Alloy globals and ignores generated code. eslint-config-axway and eslint-plugin-alloy are no longer installed: neither works under ESLint 9.
• The images: section rejects unknown keys. A typo like qualty: 95 is now an error naming the offending key and the entry index, instead of silently falling back to the default.
• The generated images: block documents the 4× convention. The comments state where the output sizes come from, why there is no width key, and which formats quality actually reaches.

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