> To build a Wix site agentically, or add Wix features like bookings or a store to a site you already have, follow https://www.wix.com/headless/skill.md
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Business Manager Redesign

## Article: Business Manager Redesign

## Article Link: https://dev.wix.com/docs/wix-design-system/guidelines/themes/business-manager-redesign.md

## Article Content:

<!-- heading -->

# Business Manager Redesign

<!-- end heading -->

The Business Manager (Wix Site Dashboard) was redesigned with the [Harmony theme](#/page/guidelines/harmonytheme). Apps run inside an iframe, so they don't inherit the new theme from the platform. Apply a few updates on your side to complete the migration.

Follow the steps below. Steps 1 to 4 are code changes. Steps 5 and 6 need a design review.

## 1. Update @wix/design-system

The redesigned component styles ship in recent releases. Update to the latest version:

<!-- grid layout -->
<!-- grid layout item -->
<!-- grid layout content -->

```bash
npm install @wix/design-system@latest
```

<!-- end grid layout content -->
<!-- end grid layout item -->
<!-- end grid layout -->

Keep the package up to date during the rollout. Style refinements ship continuously, so an older version can leave your app with a partial redesign.

## 2. Update @wix/wix-ui-icons-common

The redesign introduces a new icon set, drawn with 1.5px strokes at 18px and 24px. It is available in recent releases of the icon library:

<!-- grid layout -->
<!-- grid layout item -->
<!-- grid layout content -->

```bash
npm install @wix/wix-ui-icons-common@latest
```

<!-- end grid layout content -->
<!-- end grid layout item -->
<!-- end grid layout -->

Update both packages together. The latest components expect the matching icon set.

## 3. Set up the theme in your app

Your app runs in an iframe, so it doesn't get theme styles from the Business Manager. Set up the theme as follows:

1. **Load the theme tokens.** Import the `odeditor` token stylesheet together with the base styles. Other loading options, such as CDN links, are described in [Theming](#/page/introduction/theming).
2. **Add the icon theming providers.** Wrap your app with `WixDesignSystemIconThemeProvider` and `IconThemeProvider` so that icons use the new icon set. See [Icon Theming](#/page/foundations/icontheming/icontheming) for details.
3. **Apply the Business Manager defaults.** Wrap your app with [WixDesignSystemDefaultPropsProvider](#/component/wixdesignsystemdefaultpropsprovider) to set the redesign's default sizes and skins. Props set on an individual component still override them.

All three combined:

<!-- grid layout -->
<!-- grid layout item -->
<!-- grid layout content -->

```tsx
import '@wix/design-system/styles.global.css';
import '@wix/design-system/themes/odeditor.global.css';
import {
  WixDesignSystemProvider,
  WixDesignSystemIconThemeProvider,
  WixDesignSystemDefaultPropsProvider,
  type WixDesignSystemDefaultProps,
} from '@wix/design-system';
import { IconThemeProvider } from '@wix/wix-ui-icons-common/core';

const NEW_ODEDITOR_DEFAULTS: WixDesignSystemDefaultProps = {
  Button: { size: 'small', skin: 'dark' },
  IconButton: { size: 'small', skin: 'dark', priority: 'tertiary' },
  TextButton: { size: 'small', skin: 'standard' },
  Input: { size: 'small' },
};

export default function App() {
  return (
    <WixDesignSystemProvider>
      <WixDesignSystemIconThemeProvider>
        <IconThemeProvider theme="odeditor">
          <WixDesignSystemDefaultPropsProvider
            defaults={NEW_ODEDITOR_DEFAULTS}
          >
            {/* your app */}
          </WixDesignSystemDefaultPropsProvider>
        </IconThemeProvider>
      </WixDesignSystemIconThemeProvider>
    </WixDesignSystemProvider>
  );
}
```

<!-- end grid layout content -->
<!-- end grid layout item -->
<!-- end grid layout -->

## 4. Import icons from the lazy entry point

Icons imported from the package root always render in the classic style. Icons imported from the lazy entry point render in the style selected by the providers from step 3. In Business Manager they render the new icon set. In other environments they keep the current one.

Update your imports:

<!-- grid layout -->
<!-- grid layout item -->
<!-- grid layout content -->

```diff
- import { Add } from '@wix/wix-ui-icons-common';
- import { Confirm } from '@wix/wix-ui-icons-common/system';
+ import { Add } from '@wix/wix-ui-icons-common/lazy';
+ import { Confirm } from '@wix/wix-ui-icons-common/lazy/system';
```

<!-- end grid layout content -->
<!-- end grid layout item -->
<!-- end grid layout -->

You can migrate imports incrementally, screen by screen. Icons imported from the root keep rendering in the classic style until you update them.

## 5. Apply manual adjustments

Some components need manual changes to match the redesign. The full list is in section 6 of the [Harmony theme guidelines](#/page/guidelines/harmonytheme). In short:

| Component | Adjustment |
| --- | --- |
| Accordion | Change the chevron manually |
| Panel and modal headers | Update the close button and use the `tiny` size for the question mark icon |
| Modal footers | Replace the secondary button with a text button at M size, use the light footer skin and remove the divider |
| Slider | Set horizontal spacing to 12px instead of 8px |
| Components with built-in buttons | Change the nested icon button to Dark / Tertiary |
| Tabs | Use the `small` size and turn the divider off |
| Angle input | Change to medium (38px height) |

Business Manager also has its own defaults, described in section 5 of the same page. The provider from step 3 covers the button and input defaults. The rest need attention in your layouts:

* Standalone text buttons use the standard (blue) skin. A text button next to a primary or secondary button uses the Dark skin.
* Panels, cards and modals no longer have dividers in their headers and footers. Keep them removed.
* Empty states use typography only. Remove legacy illustrations.

## 6. Replace custom styles with design tokens

Hardcoded values don't update with the theme. A hardcoded color or font size keeps its old value while the components around it change, which makes a page look half migrated.

Replace the following:

* Hardcoded values with `--wds-*` design tokens
* Inline `style` overrides on components with the matching `skin` or `size` props.

The [Token Migration Guidelines](#/page/guidelines/tokensmigration) describe the process and include token mapping tables. A [plain markdown version](https://static.parastorage.com/services/design-system-documentation/1.128.0/janet/llms/page/guidelines/tokensmigration.md) of that page is available to share with an AI coding assistant.

## Verify your app

* Confirm your app loads the design system styles and theme tokens correctly, as described in [Theming](#/page/introduction/theming).
* Inspect a component in the browser developer tools. Its colors should resolve from `--wds-*` custom properties. A hardcoded value means the element still uses custom styling.
* Check every interactive and feedback state: hover, focus, disabled, selected, error, warning and success.
* Check custom code that reads colors in JavaScript. Design tokens are CSS custom properties, so values copied into JavaScript objects don't change with the theme.

---

## Related guidelines

* [Harmony theme](#/page/guidelines/harmonytheme)
* [Token Migration Guidelines](#/page/guidelines/tokensmigration)
* [Theming](#/page/introduction/theming)
* [Icon Theming](#/page/foundations/icontheming/icontheming)