migrating-to-westpac-ui-v1
Migrating to @westpac/ui v1.0
Guide for migrating existing applications from pre-1.0 @westpac/ui to v1.0. For fresh installations, use the installing-westpac-ui skill instead.
When to Use
Reference this guide when a user is using and older version of @westpac/ui (check package.json) and wants to upgrade to v1.0. This includes understanding the major breaking changes, running the token codemod, updating Tailwind CSS configuration, and fixing component API changes.
Major Changes from v0.x
v1.0 introduces a new architecture separating UI components from style configuration:
@westpac/style-configis a new required package that provides:- Tailwind tokens
- Light/dark theming
- CSS + W3C design tokens
- Tailwind CSS upgraded from v3 to v4
- All color tokens renamed to support multi-brand + dual-theme
More from westpacgel/gel-next
using-westpac-ui
Guides consumers of the @westpac/ui component library on correct usage, capabilities, and patterns. Use when asking how to use a GEL component, whether a component supports a feature, or how to implement a UI pattern with @westpac/ui.
12installing-westpac-ui
Guides setup and installation of @westpac/ui and @westpac/style-config in a new project. Use when setting up GEL, installing the design system, configuring Tailwind CSS, theming, or brand fonts.
11