Scaffolding

your-plugin/
├── package.json            # workspace root
├── pnpm-workspace.yaml
├── LICENSE
├── README.md
├── .gitignore
└── packages/
    └── dashboard/
        ├── package.json    # @your-scope/dashboard-your-plugin
        ├── tsconfig.json
        ├── biome.json
        └── src/
            ├── index.tsx   # defineDashboardPlugin entry
            ├── client.ts   # adminClient request wrappers
            ├── types.ts    # plugin-specific TS types
            ├── pages/
            │   └── <name>-list.tsx
            ├── routes/     # TanStack file routes, compiled into the host's typed route tree
            │   └── <name>.index.tsx
            ├── slots/
            │   └── product-<name>-card.tsx
            └── locales/
                └── en.json

npx @spree/cli plugin new my-plugin

npx @spree/cli plugin new my-plugin \
  --ruby-name spree_my_plugin \
  --module-name MyPlugin \
  --npm-scope @acme \
  --author "Ada Lovelace" \
  --author-email "ada@example.com" \
  --license MIT \
  --no-install        # skip pnpm install

npx @spree/cli plugin new my-plugin -y

cd my-plugin
pnpm install          # runs by default unless --no-install
pnpm build

import { defineDashboardPlugin, defineTable, i18n } from '@spree/dashboard-core'
import { PackageIcon } from 'lucide-react'
import en from './locales/en.json'
import { MyPluginCard } from './slots/product-my-plugin-card'

// 1. Translations — merge our keys into the shared bundle.
i18n.addResourceBundle('en', 'translation', en, true, true)

// 2. Declare the table our list page renders with <ResourceTable>.
defineTable('my-plugin', {
  title: i18n.t('admin.my_plugin.table.title'),
  defaultSort: { field: 'name', direction: 'asc' },
  columns: [/* … */],
})

// 3. Registry extensions. Routes are NOT registered here — they ship as
// file routes in src/routes/ (declared via the package.json marker) and
// compile into the host's typed route tree. See the routes guide.
defineDashboardPlugin({
  nav: [{
    key: 'my-plugin',
    label: i18n.t('admin.my_plugin.title'),
    path: '/my-plugin',
    icon: PackageIcon,
    position: 250,
  }],
  slots: {
    'product.form_sidebar': [{
      id: 'my-plugin-card',
      component: MyPluginCard as never,
      position: 50,
    }],
  },
})