Use and extend the theme

An app installs the integration and applies or extends your theme, the same as any theme.

Apply the theme

An app installs the integration as a dependency and applies your theme like any Astryx theme: wrap the app in <Theme>. The theme comes from the installed package — there is no copy step. Your theme only names its fonts; the app loads them (astryx docs cli/integrations/building-blocks/themes/fonts-and-assets).

tsx
import {Theme} from '@astryxdesign/core/theme';
import {oceanTheme} from '@acme/astryx-widgets/themes/ocean';
​
<Theme theme={oceanTheme}>{/* app */}</Theme>

The import specifier is whatever your integration exports for the theme. Applying a theme — mode, SSR, and the production build — works the same for every theme; see astryx docs theme.

Extend to customize

To change a theme, an app does not copy it — it derives a new one with extends: import your theme and override only the tokens it changes. See astryx docs cli/integrations/building-blocks/themes/define-the-theme.