wix-cli-dashboard-page

Create a folder under src/extensions/dashboard/pages with a page.tsx component wrapped in WixDesignSystemProvider, then add an extensions.ts file calling extensions.dashboardPage() with a unique UUID, title, routePath, and component path. Finally register it in src/extensions.ts.

Use dashboard.openModal() with a dashboard modal extension ID instead of the WDS Modal component or custom React modals. Dashboard modals integrate properly with the dashboard lifecycle, state management, and navigation.

Import items from @wix/data and use items.query('Collection').filter().find() for reads and items.insert, update, or remove for writes. Update calls must include the item's _id inside the data object, and collection permissions must allow the action.

The page extension must be registered in two places: a page-specific extensions.ts file with a unique static UUID, and the main src/extensions.ts file. Missing the second registration step is the most common cause.

Use embeddedScripts from @wix/app-management: load values with getEmbeddedScript() and save with embedScript({ parameters }). All parameter values must be strings, so convert booleans and numbers when saving and parse them back when loading.