Behind the screens: Building Atlassian's new icon system
Sep 9, 2025Jesse Bauer, Zac Sanderson-Harris, Andrew Campbell

Summary
This post details the technical and design evolution of Atlassian's icon system. Key contributions include: refining icon design with a 1.5px stroke on a 16px canvas, creating both 16x16px core icons and downscaled 12x12px utility icons, and establishing a taxonomy of single-purpose and multi-purpose icons. It also describes the development of Icon Lab, a centralized contribution platform with a custom Figma plugin for automated layout, export, and publishing. Migration tooling, such as feature flagging, backwards-compatibility props, an ESLint rule with auto-fixer, and an 'Icon Facade' for safe testing, is also detailed.