Theming wallet surfaces
Start with UI customization. Seams renders UI in two places: React components on the application origin and protected surfaces on the wallet origin. Use the same color roles and shape settings in both places.
Apply a theme
- Use
Themeand its tokens for app-owned React components. - Set
appearanceduring SDK configuration, or callseams.config.setAppearance, for the auth menu, confirmer, and export viewer inside the wallet iframe. - Start from
LIGHT_TOKENS,DARK_TOKENS, and oneSHAPE_PRESETSbranch. - Override semantic roles as a complete light/dark pair.
- Check text contrast, visible focus, status meaning, and forced-color behavior after every palette change.
See the detailed token table and code in the theming reference.