info
PurgeTSS is a toolkit for building mobile apps with the Titanium framework. It adds practical utilities for styling and setup work.
It includes utility classes, icon font support, an Animation module, a simple grid system, and the shades command for generating custom colors.
If you build UI-heavy screens, PurgeTSS keeps you from hand-writing long TSS files.
What it does:
- 23,300+ utility classes for colors, spacing, typography, layout, and more.
- Parses XML files and writes an
app.tsswith 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-fontsinstalls custom fonts in Alloy or Classic; TSS class definitions are generated only for Alloy.shadescommand 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
- Customization
- The UI Module
- Best Practices
- Grid System
Changelog
Unreleased
v7.17.1
- The notification icon is now named
notificationicon.png.firebase.cloudmessagingresolves that exact name, so data messages find the icon without any manifest wiring; under the oldic_stat_notifyname they fell back to the opaque launcher icon and the status bar showed a white blob. Projects that wired@drawable/ic_stat_notifyby hand update onemeta-dataline and delete the five stale files.
v7.17.0
--dependenciesscaffolds an ESLint setup that runs. The template iseslint.config.mjs, a flat config for ESLint 9 that declares the Titanium and Alloy globals and ignores generated code.eslint-config-axwayandeslint-plugin-alloyare no longer installed: neither works under ESLint 9.- The
images:section rejects unknown keys. A typo likequalty: 95is 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 nowidthkey, and which formatsqualityactually reaches.
v7.16.2
- Custom-font modules expose every processed family.
build-fonts --modulemaps 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.
shadesupdates onlypurgetss/config.cjs, whilecolor-modulewrites the CommonJS file underResources/lib/without initializing brand, font, image, or Alloy scaffolding.
→ See the full changelog for older releases (v7.16.1 and earlier).