Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Export the app shell as <Dashboard /> from @spree/dashboard

Damian Legawiecf6e9654f0212
diff --git a/packages/dashboard-core/src/vite/index.ts b/packages/dashboard-core/src/vite/index.ts
index 63acdb9dcd..6cd4538be2 100644
--- a/packages/dashboard-core/src/vite/index.ts
+++ b/packages/dashboard-core/src/vite/index.ts
@@ -156,6 +156,11 @@ function dashboardTailwindSourcePlugin(options: SpreeDashboardPluginOptions): Pl
pluginErrors.push({ pkg, kind: 'unresolved' })
}
}
+ // The app shell is optional: present when the host builds on the full
+ // `@spree/dashboard` package, absent for custom dashboards composed
+ // directly from core + ui — hence no error when unresolved.
+ const shellDir = resolvePackageSourceDir('@spree/dashboard', fromHost)
+ if (shellDir) resolvedSources.push(shellDir)
for (const pkg of pluginPackages) {
const dir = resolvePackageSourceDir(pkg, fromHost)
if (dir) {
diff --git a/packages/dashboard/package.json b/packages/dashboard/package.json
index d5931638f8..4d82285eaa 100644
--- a/packages/dashboard/package.json
+++ b/packages/dashboard/package.json
@@ -5,8 +5,10 @@
"version": "0.0.0",
"type": "module",
"exports": {
+ ".": "./src/dashboard.tsx",
"./styles.css": "./src/styles.css",
- "./vite": "./src/vite/index.ts"
+ "./vite": "./src/vite/index.ts",
+ "./components/spree/payment-method-editors/types": "./src/components/spree/payment-method-editors/types.ts"
},
"files": [
"src",
diff --git a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx
index 8f0dca09ae..04ec258de4 100644
--- a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx
+++ b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor-dialog.tsx
@@ -17,10 +17,7 @@ import {
import { XIcon } from 'lucide-react'
import { useCallback, useEffect, useState } from 'react'
import { useTranslation } from 'react-i18next'
-import {
- BulkPriceEditor,
- type BulkPriceEditorState,
-} from '@/components/spree/bulk-price-editor/bulk-price-editor'
+import { BulkPriceEditor, type BulkPriceEditorState } from './bulk-price-editor'
interface BulkPriceEditorDialogProps {
open: boolean
diff --git a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor.tsx b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor.tsx
index 3dfc3fbe8f..b6f6095bd8 100644
--- a/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor.tsx
+++ b/packages/dashboard/src/components/spree/bulk-price-editor/bulk-price-editor.tsx
@@ -5,8 +5,8 @@ import { useQuery } from '@tanstack/react-query'
import { useCallback, useDeferredValue, useEffect, useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useCurrencyLocale } from '@/hooks/use-currency-locale'
-import { useBulkUpsertPrices } from '@/hooks/use-prices'
+import { useCurrencyLocale } from '../../../hooks/use-currency-locale'
+import { useBulkUpsertPrices } from '../../../hooks/use-prices'
import { currencyParts } from './currency-parts'
import { normalizeMoneyInput } from './normalize-money'
diff --git a/packages/dashboard/src/components/spree/bulk-price-editor/product-bulk-price-editor.tsx b/packages/dashboard/src/components/spree/bulk-price-editor/product-bulk-price-editor.tsx
index 801f7bffa7..5de787f04b 100644
--- a/packages/dashboard/src/components/spree/bulk-price-editor/product-bulk-price-editor.tsx
+++ b/packages/dashboard/src/components/spree/bulk-price-editor/product-bulk-price-editor.tsx
@@ -2,10 +2,10 @@ import { type BulkPriceRow, BulkPriceTable } from '@spree/dashboard-ui'
import { useCallback, useMemo } from 'react'
import { type UseFormReturn, useWatch } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { composeOptionsText } from '@/components/spree/products/variants-matrix'
-import { useCurrencyLocale } from '@/hooks/use-currency-locale'
-import { useOptionTypes } from '@/hooks/use-option-types'
-import type { ProductFormValues, VariantPriceFormValues } from '@/schemas/product'
+import { useCurrencyLocale } from '../../../hooks/use-currency-locale'
+import { useOptionTypes } from '../../../hooks/use-option-types'
+import type { ProductFormValues, VariantPriceFormValues } from '../../../schemas/product'
+import { composeOptionsText } from '../products/variants-matrix'
import { currencyParts } from './currency-parts'
import { normalizeMoneyInput } from './normalize-money'
diff --git a/packages/dashboard/src/components/spree/categories/category-form.tsx b/packages/dashboard/src/components/spree/categories/category-form.tsx
index 4667b9ca71..d8b2a16d8f 100644
--- a/packages/dashboard/src/components/spree/categories/category-form.tsx
+++ b/packages/dashboard/src/components/spree/categories/category-form.tsx
@@ -17,13 +17,13 @@ import {
import type { UseFormReturn } from 'react-hook-form'
import { Controller } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
+import { categoryAutocompleteProps } from '../../../hooks/use-categories'
+import type { CategoryFormValues } from '../../../schemas/category'
import {
CustomFieldsInlineCard,
FormBackedCustomFieldsProvider,
-} from '@/components/spree/custom-fields/custom-fields-inline'
-import { ResourceTranslationsCard } from '@/components/spree/translations/resource-translations-card'
-import { categoryAutocompleteProps } from '@/hooks/use-categories'
-import type { CategoryFormValues } from '@/schemas/category'
+} from '../custom-fields/custom-fields-inline'
+import { ResourceTranslationsCard } from '../translations/resource-translations-card'
import { CategoryImageField } from './category-image-field'
import { CategoryProductsCard } from './category-products-card'
diff --git a/packages/dashboard/src/components/spree/categories/category-image-field.tsx b/packages/dashboard/src/components/spree/categories/category-image-field.tsx
index cf1dba9731..12e4771719 100644
--- a/packages/dashboard/src/components/spree/categories/category-image-field.tsx
+++ b/packages/dashboard/src/components/spree/categories/category-image-field.tsx
@@ -1,7 +1,7 @@
import { ImageUploadField } from '@spree/dashboard-core'
import type { UseFormReturn } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import type { CategoryFormValues } from '@/schemas/category'
+import type { CategoryFormValues } from '../../../schemas/category'
type ImageKind = 'image' | 'square_image'
diff --git a/packages/dashboard/src/components/spree/categories/category-products-card.tsx b/packages/dashboard/src/components/spree/categories/category-products-card.tsx
index 291ef9d9bb..e4fe03036e 100644
--- a/packages/dashboard/src/components/spree/categories/category-products-card.tsx
+++ b/packages/dashboard/src/components/spree/categories/category-products-card.tsx
@@ -46,7 +46,7 @@ import {
useRemoveCategoryProduct,
useRemoveCategoryProducts,
useRepositionCategoryProduct,
-} from '@/hooks/use-categories'
+} from '../../../hooks/use-categories'
/**
* Manual product membership + ordering for a category — the SPA equivalent of
diff --git a/packages/dashboard/src/components/spree/channel-select.tsx b/packages/dashboard/src/components/spree/channel-select.tsx
index 040772301b..d2c6c693bd 100644
--- a/packages/dashboard/src/components/spree/channel-select.tsx
+++ b/packages/dashboard/src/components/spree/channel-select.tsx
@@ -1,6 +1,6 @@
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@spree/dashboard-ui'
import { useTranslation } from 'react-i18next'
-import { useChannels } from '@/hooks/use-channels'
+import { useChannels } from '../../hooks/use-channels'
interface ChannelSelectProps {
/** ID for the trigger — paired with the parent `<FieldLabel htmlFor>`. */
diff --git a/packages/dashboard/src/components/spree/custom-fields/custom-fields-inline.tsx b/packages/dashboard/src/components/spree/custom-fields/custom-fields-inline.tsx
index 39f2705923..50f516bb48 100644
--- a/packages/dashboard/src/components/spree/custom-fields/custom-fields-inline.tsx
+++ b/packages/dashboard/src/components/spree/custom-fields/custom-fields-inline.tsx
@@ -63,14 +63,14 @@ import { createContext, type ReactNode, useCallback, useContext, useMemo, useSta
import { type UseFormReturn, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { DefinitionFormFields } from '@/components/spree/custom-fields/definition-form'
import {
CUSTOM_FIELD_DEFINITION_DEFAULTS,
type CustomFieldDefinitionFormValues,
customFieldDefinitionSchema,
customFieldDefinitionValuesToCreateParams,
-} from '@/schemas/custom-field-definition'
-import type { CustomFieldFormValues } from '@/schemas/product'
+} from '../../../schemas/custom-field-definition'
+import type { CustomFieldFormValues } from '../../../schemas/product'
+import { DefinitionFormFields } from './definition-form'
// ---------------------------------------------------------------------------
// Generic context interface — providers implement this, the card consumes it.
diff --git a/packages/dashboard/src/components/spree/custom-fields/definition-form.tsx b/packages/dashboard/src/components/spree/custom-fields/definition-form.tsx
index d4566e726e..a078c9433c 100644
--- a/packages/dashboard/src/components/spree/custom-fields/definition-form.tsx
+++ b/packages/dashboard/src/components/spree/custom-fields/definition-form.tsx
@@ -18,7 +18,7 @@ import {
FIELD_TYPES,
fieldTypeLabel,
resourceTypeLabel,
-} from '@/schemas/custom-field-definition'
+} from '../../../schemas/custom-field-definition'
interface DefinitionFormFieldsProps {
form: UseFormReturn<CustomFieldDefinitionFormValues>
diff --git a/packages/dashboard/src/components/spree/payment-method-editors/types.ts b/packages/dashboard/src/components/spree/payment-method-editors/types.ts
index 038f414315..2b7af2728f 100644
--- a/packages/dashboard/src/components/spree/payment-method-editors/types.ts
+++ b/packages/dashboard/src/components/spree/payment-method-editors/types.ts
@@ -1,6 +1,6 @@
import type { PaymentMethod, PreferenceField } from '@spree/admin-sdk'
import type { UseFormReturn } from 'react-hook-form'
-import type { PaymentMethodFormValues } from '@/schemas/payment-method'
+import type { PaymentMethodFormValues } from '../../../schemas/payment-method'
/**
* Form-state row for a payment method — the in-flight values an editor
diff --git a/packages/dashboard/src/components/spree/price-list-editors/price-list-form.tsx b/packages/dashboard/src/components/spree/price-list-editors/price-list-form.tsx
index fe6821a138..d676c1ddde 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/price-list-form.tsx
+++ b/packages/dashboard/src/components/spree/price-list-editors/price-list-form.tsx
@@ -22,12 +22,12 @@ import {
import { useEffect, useState } from 'react'
import { Controller, type UseFormReturn, useFieldArray, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { BulkPriceEditorDialog } from '@/components/spree/bulk-price-editor/bulk-price-editor-dialog'
-import { PriceListStatusBadge } from '@/components/spree/price-list-editors/status-badge'
+import { BulkPriceEditorDialog } from '../bulk-price-editor/bulk-price-editor-dialog'
+import { PriceListStatusBadge } from './status-badge'
// Side-effect import — registers per-rule editors (customer, customer
// group, …) into the slot registry. Must run before any RuleEditSheet
// mounts.
-import '@/components/spree/price-list-editors/register'
+import './register'
import { mapSpreeErrorsToForm, Slot, StoreDatePicker, Subject } from '@spree/dashboard-core'
import {
Button,
@@ -53,16 +53,11 @@ import {
SheetTitle,
Textarea,
} from '@spree/dashboard-ui'
-import {
- type PriceRuleEditorContext,
- ruleFormSlot,
-} from '@/components/spree/price-list-editors/types'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
import {
useActivatePriceList,
useDeactivatePriceList,
usePriceRuleTypes,
-} from '@/hooks/use-price-lists'
+} from '../../../hooks/use-price-lists'
import {
MATCH_POLICIES,
PRICE_LIST_DEFAULTS,
@@ -72,7 +67,9 @@ import {
priceListValuesToParams,
ruleDraftFromRule,
ruleDraftFromType,
-} from '@/schemas/price-list'
+} from '../../../schemas/price-list'
+import { EditorShell } from '../promotion-editors/editor-shell'
+import { type PriceRuleEditorContext, ruleFormSlot } from './types'
// =============================================================================
// Public API
diff --git a/packages/dashboard/src/components/spree/price-list-editors/rule-channel.tsx b/packages/dashboard/src/components/spree/price-list-editors/rule-channel.tsx
index 4c256ad5ae..3827b0741d 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/rule-channel.tsx
+++ b/packages/dashboard/src/components/spree/price-list-editors/rule-channel.tsx
@@ -3,8 +3,8 @@ import { ResourceMultiAutocomplete } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
-import { channelAutocompleteProps, useChannels } from '@/hooks/use-channels'
+import { channelAutocompleteProps, useChannels } from '../../../hooks/use-channels'
+import { EditorShell } from '../promotion-editors/editor-shell'
import type { PriceRuleEditorContext } from './types'
/**
diff --git a/packages/dashboard/src/components/spree/price-list-editors/rule-customer-group.tsx b/packages/dashboard/src/components/spree/price-list-editors/rule-customer-group.tsx
index 583a21dd95..8dc76c42bc 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/rule-customer-group.tsx
+++ b/packages/dashboard/src/components/spree/price-list-editors/rule-customer-group.tsx
@@ -3,8 +3,11 @@ import { ResourceMultiAutocomplete } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
-import { customerGroupAutocompleteProps, useCustomerGroups } from '@/hooks/use-customer-groups'
+import {
+ customerGroupAutocompleteProps,
+ useCustomerGroups,
+} from '../../../hooks/use-customer-groups'
+import { EditorShell } from '../promotion-editors/editor-shell'
import type { PriceRuleEditorContext } from './types'
export function CustomerGroupRuleEditor({ draft, onSave, onClose }: PriceRuleEditorContext) {
diff --git a/packages/dashboard/src/components/spree/price-list-editors/rule-customer.tsx b/packages/dashboard/src/components/spree/price-list-editors/rule-customer.tsx
index adcd125bc6..0a686852a3 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/rule-customer.tsx
+++ b/packages/dashboard/src/components/spree/price-list-editors/rule-customer.tsx
@@ -3,8 +3,8 @@ import { ResourceMultiAutocomplete } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
-import { customerAutocompleteProps } from '@/hooks/use-customers'
+import { customerAutocompleteProps } from '../../../hooks/use-customers'
+import { EditorShell } from '../promotion-editors/editor-shell'
import type { PriceRuleEditorContext } from './types'
/**
diff --git a/packages/dashboard/src/components/spree/price-list-editors/rule-market.tsx b/packages/dashboard/src/components/spree/price-list-editors/rule-market.tsx
index 9e0d20674d..2705d1e096 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/rule-market.tsx
+++ b/packages/dashboard/src/components/spree/price-list-editors/rule-market.tsx
@@ -3,8 +3,8 @@ import { MarketMultiCombobox } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
-import { useAllMarkets } from '@/hooks/use-markets'
+import { useAllMarkets } from '../../../hooks/use-markets'
+import { EditorShell } from '../promotion-editors/editor-shell'
import type { PriceRuleEditorContext } from './types'
/**
diff --git a/packages/dashboard/src/components/spree/price-list-editors/types.ts b/packages/dashboard/src/components/spree/price-list-editors/types.ts
index be53f0ab42..14be7c76ea 100644
--- a/packages/dashboard/src/components/spree/price-list-editors/types.ts
+++ b/packages/dashboard/src/components/spree/price-list-editors/types.ts
@@ -1,4 +1,4 @@
-import type { PriceRuleFormDraft } from '@/schemas/price-list'
+import type { PriceRuleFormDraft } from '../../../schemas/price-list'
/**
* Slot context for a price rule editor. Editors mutate the draft
diff --git a/packages/dashboard/src/components/spree/products/inventory-section.tsx b/packages/dashboard/src/components/spree/products/inventory-section.tsx
index 322aeef864..e9763d6971 100644
--- a/packages/dashboard/src/components/spree/products/inventory-section.tsx
+++ b/packages/dashboard/src/components/spree/products/inventory-section.tsx
@@ -11,9 +11,9 @@ import { ExternalLinkIcon } from 'lucide-react'
import { useCallback, useMemo } from 'react'
import { type UseFormReturn, useWatch } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { useOptionTypes } from '@/hooks/use-option-types'
-import { useStockLocations } from '@/hooks/use-stock-locations'
-import type { ProductFormValues, StockItemFormValues } from '@/schemas/product'
+import { useOptionTypes } from '../../../hooks/use-option-types'
+import { useStockLocations } from '../../../hooks/use-stock-locations'
+import type { ProductFormValues, StockItemFormValues } from '../../../schemas/product'
import { composeOptionsText } from './variants-matrix'
interface InventoryRow {
diff --git a/packages/dashboard/src/components/spree/products/media-edit-sheet.tsx b/packages/dashboard/src/components/spree/products/media-edit-sheet.tsx
index 3c2006d827..50d7007d9c 100644
--- a/packages/dashboard/src/components/spree/products/media-edit-sheet.tsx
+++ b/packages/dashboard/src/components/spree/products/media-edit-sheet.tsx
@@ -15,7 +15,7 @@ import i18n from 'i18next'
import { CheckIcon, ImagePlusIcon } from 'lucide-react'
import { useCallback, useEffect, useRef } from 'react'
import type { UseFormReturn } from 'react-hook-form'
-import type { ProductFormValues } from '@/schemas/product'
+import type { ProductFormValues } from '../../../schemas/product'
interface Props {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
diff --git a/packages/dashboard/src/components/spree/products/product-form-cards.tsx b/packages/dashboard/src/components/spree/products/product-form-cards.tsx
index 32fb1d3d49..023a6f4ec1 100644
--- a/packages/dashboard/src/components/spree/products/product-form-cards.tsx
+++ b/packages/dashboard/src/components/spree/products/product-form-cards.tsx
@@ -44,14 +44,14 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
import { Controller, type UseFormReturn, useWatch } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { ProductBulkPriceEditor } from '@/components/spree/bulk-price-editor/product-bulk-price-editor'
-import { InventorySection } from '@/components/spree/products/inventory-section'
-import { MediaEditSheet } from '@/components/spree/products/media-edit-sheet'
-import { VariantsSection } from '@/components/spree/products/variants-section'
-import { categoryAutocompleteProps, useCategories } from '@/hooks/use-categories'
-import { useDeleteProductMedia } from '@/hooks/use-product-media'
-import { useTaxCategories } from '@/hooks/use-tax-categories'
-import type { ProductFormValues } from '@/schemas/product'
+import { categoryAutocompleteProps, useCategories } from '../../../hooks/use-categories'
+import { useDeleteProductMedia } from '../../../hooks/use-product-media'
+import { useTaxCategories } from '../../../hooks/use-tax-categories'
+import type { ProductFormValues } from '../../../schemas/product'
+import { ProductBulkPriceEditor } from '../bulk-price-editor/product-bulk-price-editor'
+import { InventorySection } from './inventory-section'
+import { MediaEditSheet } from './media-edit-sheet'
+import { VariantsSection } from './variants-section'
// eslint-disable-next-line @typescript-eslint/no-explicit-any
type FormCardProps = { form: UseFormReturn<ProductFormValues, any, any> }
diff --git a/packages/dashboard/src/components/spree/products/publishing-card.tsx b/packages/dashboard/src/components/spree/products/publishing-card.tsx
index 8ccb896923..c1752a689c 100644
--- a/packages/dashboard/src/components/spree/products/publishing-card.tsx
+++ b/packages/dashboard/src/components/spree/products/publishing-card.tsx
@@ -22,8 +22,8 @@ import { PencilIcon, SettingsIcon } from 'lucide-react'
import { useEffect, useMemo, useRef, useState } from 'react'
import { Controller, type UseFormReturn, useFieldArray } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { useChannels } from '@/hooks/use-channels'
-import type { ProductFormValues } from '@/schemas/product'
+import { useChannels } from '../../../hooks/use-channels'
+import type { ProductFormValues } from '../../../schemas/product'
type ProductForm = UseFormReturn<ProductFormValues>
diff --git a/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx b/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx
index 1b2452835e..426d0ab727 100644
--- a/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx
+++ b/packages/dashboard/src/components/spree/products/variant-edit-sheet.tsx
@@ -20,9 +20,9 @@ import {
import { useEffect, useRef } from 'react'
import { Controller, type UseFormReturn } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { useOptionTypes } from '@/hooks/use-option-types'
-import { useTaxCategories } from '@/hooks/use-tax-categories'
-import type { ProductFormValues, VariantFormValues } from '@/schemas/product'
+import { useOptionTypes } from '../../../hooks/use-option-types'
+import { useTaxCategories } from '../../../hooks/use-tax-categories'
+import type { ProductFormValues, VariantFormValues } from '../../../schemas/product'
import { variantDisplayLabel } from './variants-matrix'
const WEIGHT_UNITS = ['g', 'kg', 'lb', 'oz'] as const
diff --git a/packages/dashboard/src/components/spree/products/variant-media-picker.tsx b/packages/dashboard/src/components/spree/products/variant-media-picker.tsx
index ebb0f94fcd..99fa545cc7 100644
--- a/packages/dashboard/src/components/spree/products/variant-media-picker.tsx
+++ b/packages/dashboard/src/components/spree/products/variant-media-picker.tsx
@@ -10,8 +10,8 @@ import {
import { CheckIcon, ImagePlusIcon, Loader2Icon } from 'lucide-react'
import { useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { useProductMedia, useUpdateProductMedia } from '@/hooks/use-product-media'
-import { useVariantMedia } from '@/hooks/use-variant-media'
+import { useProductMedia, useUpdateProductMedia } from '../../../hooks/use-product-media'
+import { useVariantMedia } from '../../../hooks/use-variant-media'
type Props = {
productId: string
diff --git a/packages/dashboard/src/components/spree/products/variants-matrix.ts b/packages/dashboard/src/components/spree/products/variants-matrix.ts
index 5960901c0f..47b577ea80 100644
--- a/packages/dashboard/src/components/spree/products/variants-matrix.ts
+++ b/packages/dashboard/src/components/spree/products/variants-matrix.ts
@@ -5,7 +5,7 @@
// (no React) so they can evolve independently of the UI shell.
import type { OptionType } from '@spree/admin-sdk'
-import type { VariantFormValues } from '@/schemas/product'
+import type { VariantFormValues } from '../../../schemas/product'
export interface SelectedOptionValue {
name: string
diff --git a/packages/dashboard/src/components/spree/products/variants-options-builder.tsx b/packages/dashboard/src/components/spree/products/variants-options-builder.tsx
index 5859c61a2b..c1d73024a7 100644
--- a/packages/dashboard/src/components/spree/products/variants-options-builder.tsx
+++ b/packages/dashboard/src/components/spree/products/variants-options-builder.tsx
@@ -15,7 +15,11 @@ import { CheckIcon, PencilIcon, PlusIcon, XIcon } from 'lucide-react'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useCreateOptionType, useOptionTypes, useUpdateOptionType } from '@/hooks/use-option-types'
+import {
+ useCreateOptionType,
+ useOptionTypes,
+ useUpdateOptionType,
+} from '../../../hooks/use-option-types'
import type { SelectedOptionType } from './variants-matrix'
interface Props {
diff --git a/packages/dashboard/src/components/spree/products/variants-section.tsx b/packages/dashboard/src/components/spree/products/variants-section.tsx
index cfac18ec7b..35a7f6b104 100644
--- a/packages/dashboard/src/components/spree/products/variants-section.tsx
+++ b/packages/dashboard/src/components/spree/products/variants-section.tsx
@@ -35,8 +35,8 @@ import { PencilIcon, XIcon } from 'lucide-react'
import { type CSSProperties, useMemo, useState } from 'react'
import { type UseFormReturn, useFieldArray, useWatch } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { useOptionTypes } from '@/hooks/use-option-types'
-import type { ProductFormValues, VariantFormValues } from '@/schemas/product'
+import { useOptionTypes } from '../../../hooks/use-option-types'
+import type { ProductFormValues, VariantFormValues } from '../../../schemas/product'
import { VariantEditSheet } from './variant-edit-sheet'
import {
generateVariantCombinations,
diff --git a/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx b/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx
index 2ca478b72d..92ecba072b 100644
--- a/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx
+++ b/packages/dashboard/src/components/spree/promotion-editors/action-adjustment.tsx
@@ -13,7 +13,7 @@ import {
import { useQuery } from '@tanstack/react-query'
import { useEffect, useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { typeLabel } from '@/lib/type-labels'
+import { typeLabel } from '../../../lib/type-labels'
import { EditorShell } from './editor-shell'
import type { PromotionActionEditorContext } from './types'
diff --git a/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx b/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx
index 46b365f74d..4169e376fd 100644
--- a/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx
+++ b/packages/dashboard/src/components/spree/promotion-editors/promotion-form.tsx
@@ -15,8 +15,8 @@ import { DownloadIcon, PlusIcon, SparklesIcon, TrashIcon } from 'lucide-react'
import { useEffect, useState } from 'react'
import { Controller, type UseFormReturn, useFieldArray, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { EditorShell } from '@/components/spree/promotion-editors/editor-shell'
-import '@/components/spree/promotion-editors/register'
+import { EditorShell } from './editor-shell'
+import './register'
import { mapSpreeErrorsToForm, Slot, Subject, useExport, useStore } from '@spree/dashboard-core'
import {
ActiveBadge,
@@ -52,6 +52,21 @@ import {
TableRow,
Textarea,
} from '@spree/dashboard-ui'
+import {
+ usePromotionActionTypes,
+ usePromotionCouponCodes,
+ usePromotionRuleTypes,
+} from '../../../hooks/use-promotions'
+import { typeDescription, typeLabel } from '../../../lib/type-labels'
+import {
+ MATCH_POLICIES,
+ type MatchPolicy,
+ PROMOTION_DEFAULTS,
+ PROMOTION_KINDS,
+ type PromotionFormValues,
+ type PromotionKind,
+ promotionFormSchema,
+} from '../../../schemas/promotion'
import {
actionDraftFromAction,
actionDraftFromType,
@@ -65,22 +80,7 @@ import {
ruleDraftFromType,
ruleDraftToPayload,
ruleFormSlot,
-} from '@/components/spree/promotion-editors/types'
-import {
- usePromotionActionTypes,
- usePromotionCouponCodes,
- usePromotionRuleTypes,
-} from '@/hooks/use-promotions'
-import { typeDescription, typeLabel } from '@/lib/type-labels'
-import {
- MATCH_POLICIES,
- type MatchPolicy,
- PROMOTION_DEFAULTS,
- PROMOTION_KINDS,
- type PromotionFormValues,
- type PromotionKind,
- promotionFormSchema,
-} from '@/schemas/promotion'
+} from './types'
// =============================================================================
// Types
@@ -96,7 +96,7 @@ import {
* accept changes to them after creation — see `permitted_params` in
* Spree::Api::V3::Admin::PromotionsController).
*/
-export type { PromotionFormValues } from '@/schemas/promotion'
+export type { PromotionFormValues } from '../../../schemas/promotion'
export interface PromotionFormPayload {
name: string
diff --git a/packages/dashboard/src/components/spree/promotion-editors/rule-channel.tsx b/packages/dashboard/src/components/spree/promotion-editors/rule-channel.tsx
index ca7769344f..fc24eaa98e 100644
--- a/packages/dashboard/src/components/spree/promotion-editors/rule-channel.tsx
+++ b/packages/dashboard/src/components/spree/promotion-editors/rule-channel.tsx
@@ -2,7 +2,7 @@ import type { Channel } from '@spree/admin-sdk'
import { ResourceMultiAutocomplete, useTranslation } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useState } from 'react'
-import { channelAutocompleteProps, useChannels } from '@/hooks/use-channels'
+import { channelAutocompleteProps, useChannels } from '../../../hooks/use-channels'
import { EditorShell } from './editor-shell'
import type { PromotionRuleEditorContext } from './types'
diff --git a/packages/dashboard/src/components/spree/promotion-editors/rule-customer-group.tsx b/packages/dashboard/src/components/spree/promotion-editors/rule-customer-group.tsx
index 82eef1fb5a..e3233c7adf 100644
--- a/packages/dashboard/src/components/spree/promotion-editors/rule-customer-group.tsx
+++ b/packages/dashboard/src/components/spree/promotion-editors/rule-customer-group.tsx
@@ -2,7 +2,10 @@ import type { CustomerGroup } from '@spree/admin-sdk'
import { ResourceMultiAutocomplete, useTranslation } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useState } from 'react'
-import { customerGroupAutocompleteProps, useCustomerGroups } from '@/hooks/use-customer-groups'
+import {
+ customerGroupAutocompleteProps,
+ useCustomerGroups,
+} from '../../../hooks/use-customer-groups'
import { EditorShell } from './editor-shell'
import type { PromotionRuleEditorContext } from './types'
diff --git a/packages/dashboard/src/components/spree/promotion-editors/rule-market.tsx b/packages/dashboard/src/components/spree/promotion-editors/rule-market.tsx
index 5c451e885a..d0e3378e44 100644
--- a/packages/dashboard/src/components/spree/promotion-editors/rule-market.tsx
+++ b/packages/dashboard/src/components/spree/promotion-editors/rule-market.tsx
@@ -2,7 +2,7 @@ import type { Market } from '@spree/admin-sdk'
import { MarketMultiCombobox, useTranslation } from '@spree/dashboard-core'
import { Field, FieldGroup, FieldLabel } from '@spree/dashboard-ui'
import { useMemo, useState } from 'react'
-import { useAllMarkets } from '@/hooks/use-markets'
+import { useAllMarkets } from '../../../hooks/use-markets'
import { EditorShell } from './editor-shell'
import type { PromotionRuleEditorContext } from './types'
diff --git a/packages/dashboard/src/components/spree/translations/resource-translations-card.tsx b/packages/dashboard/src/components/spree/translations/resource-translations-card.tsx
index 76816703db..01c91fa651 100644
--- a/packages/dashboard/src/components/spree/translations/resource-translations-card.tsx
+++ b/packages/dashboard/src/components/spree/translations/resource-translations-card.tsx
@@ -2,8 +2,11 @@ import { Button, Card, CardContent, CardHeader, CardTitle } from '@spree/dashboa
import { LanguagesIcon } from 'lucide-react'
import { useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { ResourceTranslationsDialog } from '@/components/spree/translations/resource-translations-dialog'
-import { type TranslatableResourceType, useResourceTranslations } from '@/hooks/use-translations'
+import {
+ type TranslatableResourceType,
+ useResourceTranslations,
+} from '../../../hooks/use-translations'
+import { ResourceTranslationsDialog } from './resource-translations-dialog'
interface ResourceTranslationsCardProps {
/** Public resource token, e.g. `product`, `category`, `option_type`. */
diff --git a/packages/dashboard/src/components/spree/translations/resource-translations-dialog.tsx b/packages/dashboard/src/components/spree/translations/resource-translations-dialog.tsx
index 6885d5dfaa..3c5ad0c799 100644
--- a/packages/dashboard/src/components/spree/translations/resource-translations-dialog.tsx
+++ b/packages/dashboard/src/components/spree/translations/resource-translations-dialog.tsx
@@ -32,7 +32,7 @@ import {
type TranslatableResourceType,
useLocales,
useResourceTranslations,
-} from '@/hooks/use-translations'
+} from '../../../hooks/use-translations'
/**
* Universal field-label resolver. The matrix carries each row's public
diff --git a/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx b/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx
index abe33668f6..366c56b636 100644
--- a/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx
+++ b/packages/dashboard/src/components/spree/webhook-endpoint-form.tsx
@@ -12,7 +12,10 @@ import {
import { useState } from 'react'
import { Controller, type UseFormReturn } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { WEBHOOK_EVENT_GROUPS, type WebhookEndpointFormValues } from '@/schemas/webhook-endpoint'
+import {
+ WEBHOOK_EVENT_GROUPS,
+ type WebhookEndpointFormValues,
+} from '../../schemas/webhook-endpoint'
/**
* The webhook endpoint form fields — Name / URL / Active toggle / Events
diff --git a/packages/dashboard/src/dashboard.tsx b/packages/dashboard/src/dashboard.tsx
new file mode 100644
index 0000000000..22815fc9e9
--- /dev/null
+++ b/packages/dashboard/src/dashboard.tsx
@@ -0,0 +1,52 @@
+import { AuthProvider, PermissionProvider, queryClient } from '@spree/dashboard-core'
+import { ConfirmProvider, ThemeProvider, TooltipProvider } from '@spree/dashboard-ui'
+import { QueryClientProvider } from '@tanstack/react-query'
+import { RouterProvider } from '@tanstack/react-router'
+import { StrictMode } from 'react'
+// Side-effect bootstrap: i18next (base namespace + the app's resource
+// bundle), the default sidebar nav, settings nav, and command-palette search
+// entries. Importing this module runs them — before any chrome component
+// reads the registries, and before plugin modules that call i18n.t at load.
+import './i18n-setup'
+import './nav/default'
+import './nav/settings'
+import './search/default'
+import { router } from './router'
+
+/**
+ * The Spree admin app shell: provider stack + router, fully wired.
+ *
+ * Hosts own the entry point and render this component:
+ *
+ * // src/main.tsx
+ * import { createRoot } from 'react-dom/client'
+ * import { Dashboard } from '@spree/dashboard'
+ * import 'virtual:spree-dashboard-plugins' // activate installed plugins
+ * import './styles.css'
+ *
+ * createRoot(document.getElementById('root')!).render(<Dashboard />)
+ *
+ * Import order matters: `@spree/dashboard` before the virtual plugin module,
+ * so the i18n/nav bootstrap in this file runs before plugin registration.
+ * Requires `spreeDashboardPlugin()` (from `@spree/dashboard/vite`) in the
+ * host's Vite config — it serves the virtual module and wires Tailwind.
+ */
+export function Dashboard() {
+ return (
+ <StrictMode>
+ <QueryClientProvider client={queryClient}>
+ <ThemeProvider>
+ <AuthProvider>
+ <PermissionProvider>
+ <TooltipProvider>
+ <ConfirmProvider>
+ <RouterProvider router={router} />
+ </ConfirmProvider>
+ </TooltipProvider>
+ </PermissionProvider>
+ </AuthProvider>
+ </ThemeProvider>
+ </QueryClientProvider>
+ </StrictMode>
+ )
+}
diff --git a/packages/dashboard/src/main.tsx b/packages/dashboard/src/main.tsx
index 51013c653a..cf6194fac9 100644
--- a/packages/dashboard/src/main.tsx
+++ b/packages/dashboard/src/main.tsx
@@ -1,42 +1,14 @@
-import { ConfirmProvider, TooltipProvider } from '@spree/dashboard-ui'
-import { QueryClientProvider } from '@tanstack/react-query'
-import { RouterProvider } from '@tanstack/react-router'
-import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
-// Side-effect imports: bootstrap i18next via dashboard-core (base namespace)
-// and merge the app's resource bundle; register the app's nav and command-palette
-// search entries against their registries. All must run before any chrome
-// component reads from those registries — i.e. before @/router. (Plugin entries
-// follow the same pattern.)
-import '@/i18n-setup'
-import '@/nav/default'
-import '@/nav/settings'
-import '@/search/default'
-// Activate installed dashboard plugins. The module is synthesized by
-// `spreeDashboardPlugin()` in vite.config.ts from the auto-discovered plugin
-// list (package.json deps carrying the `spree.dashboard.plugin` marker) —
-// installing a plugin needs no edit here. Must come after '@/i18n-setup' so
-// plugins can call i18n.t at module load.
+// The shell module runs the i18n/nav/search bootstrap on import — it must
+// execute before the virtual plugin module below so plugins can call i18n.t
+// at load time. (Side-effect imports are ordering barriers; Biome won't
+// reorder across them.)
+import { Dashboard } from './dashboard'
+// Activate installed dashboard plugins. Synthesized by `spreeDashboardPlugin()`
+// in vite.config.ts from the auto-discovered plugin list (package.json deps
+// carrying the `spree.dashboard.plugin` marker) — installing a plugin needs
+// no edit here.
import 'virtual:spree-dashboard-plugins'
-import { AuthProvider, PermissionProvider, queryClient } from '@spree/dashboard-core'
-import { ThemeProvider } from '@spree/dashboard-ui'
-import { router } from '@/router'
-import '@/styles.css'
+import './styles.css'
-createRoot(document.getElementById('root')!).render(
- <StrictMode>
- <QueryClientProvider client={queryClient}>
- <ThemeProvider>
- <AuthProvider>
- <PermissionProvider>
- <TooltipProvider>
- <ConfirmProvider>
- <RouterProvider router={router} />
- </ConfirmProvider>
- </TooltipProvider>
- </PermissionProvider>
- </AuthProvider>
- </ThemeProvider>
- </QueryClientProvider>
- </StrictMode>,
-)
+createRoot(document.getElementById('root')!).render(<Dashboard />)
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId.tsx
index 7855c9c72e..91fff789dd 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId.tsx
@@ -9,8 +9,8 @@ import {
import { SidebarInset, SidebarProvider } from '@spree/dashboard-ui'
import { createFileRoute, Outlet, useRouterState } from '@tanstack/react-router'
import { useEffect } from 'react'
-import { CommandPalette } from '@/components/spree/command-palette/command-palette'
-import { getAvailableUiLocales } from '@/i18n-setup'
+import { CommandPalette } from '../../components/spree/command-palette/command-palette'
+import { getAvailableUiLocales } from '../../i18n-setup'
// Derived once from the shipped locale bundles — stable for the app lifetime.
const UI_LOCALES = getAvailableUiLocales()
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx
index d360016976..8b4f2017e4 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/customers/$customerId.tsx
@@ -71,20 +71,23 @@ import {
import { type ReactNode, useEffect, useMemo, useState } from 'react'
import { Controller, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { currencyParts } from '@/components/spree/bulk-price-editor/currency-parts'
-import { normalizeMoneyInput } from '@/components/spree/bulk-price-editor/normalize-money'
+import { currencyParts } from '../../../../components/spree/bulk-price-editor/currency-parts'
+import { normalizeMoneyInput } from '../../../../components/spree/bulk-price-editor/normalize-money'
import {
CustomFieldsInlineCard,
EditableApiCustomFieldsProvider,
-} from '@/components/spree/custom-fields/custom-fields-inline'
-import { useCurrencyLocale } from '@/hooks/use-currency-locale'
-import { customerGroupAutocompleteProps, useCustomerGroups } from '@/hooks/use-customer-groups'
+} from '../../../../components/spree/custom-fields/custom-fields-inline'
+import { useCurrencyLocale } from '../../../../hooks/use-currency-locale'
+import {
+ customerGroupAutocompleteProps,
+ useCustomerGroups,
+} from '../../../../hooks/use-customer-groups'
import {
type StoreCreditUpdateParams,
useCreateCustomerStoreCredit,
useDeleteCustomerStoreCredit,
useUpdateCustomerStoreCredit,
-} from '@/hooks/use-customer-store-credits'
+} from '../../../../hooks/use-customer-store-credits'
import {
useCreateCustomerAddress,
useCustomer,
@@ -94,16 +97,19 @@ import {
useUpdateCustomer,
useUpdateCustomerAddress,
useUpdateCustomerGroups,
-} from '@/hooks/use-customers'
-import { useStoreCreditCategories } from '@/hooks/use-store-credit-categories'
-import { spreeJsonLinkResolver } from '@/lib/json-link-resolver'
-import { type CustomerProfileFormValues, customerProfileFormSchema } from '@/schemas/customer'
+} from '../../../../hooks/use-customers'
+import { useStoreCreditCategories } from '../../../../hooks/use-store-credit-categories'
+import { spreeJsonLinkResolver } from '../../../../lib/json-link-resolver'
+import {
+ type CustomerProfileFormValues,
+ customerProfileFormSchema,
+} from '../../../../schemas/customer'
import {
type EditStoreCreditFormValues,
editStoreCreditFormSchema,
type IssueStoreCreditFormValues,
issueStoreCreditFormSchema,
-} from '@/schemas/store-credit'
+} from '../../../../schemas/store-credit'
export const Route = createFileRoute('/_authenticated/$storeId/customers/$customerId')({
component: CustomerDetailPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/customers/groups.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/customers/groups.tsx
index d0ee482ade..dd103e06e6 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/customers/groups.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/customers/groups.tsx
@@ -37,14 +37,14 @@ import {
useCustomerGroup,
useDeleteCustomerGroup,
useUpdateCustomerGroup,
-} from '@/hooks/use-customer-groups'
+} from '../../../../hooks/use-customer-groups'
import {
CUSTOMER_GROUP_DEFAULTS,
type CustomerGroupFormValues,
customerGroupFormSchema,
customerGroupValuesToParams,
-} from '@/schemas/customer-group'
-import '@/tables/customer-groups'
+} from '../../../../schemas/customer-group'
+import '../../../../tables/customer-groups'
const customerGroupsSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/customers/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/customers/index.tsx
index a18404916b..abc8dc9c7a 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/customers/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/customers/index.tsx
@@ -40,21 +40,21 @@ import { useState } from 'react'
import { Controller, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { ImportWizardDialog } from '@/components/spree/imports/import-wizard-dialog'
-import { customerGroupAutocompleteProps, useCustomerGroups } from '@/hooks/use-customer-groups'
+import { ImportWizardDialog } from '../../../../components/spree/imports/import-wizard-dialog'
+import { customerGroupAutocompleteProps, useCustomerGroups } from '../../../../hooks/use-customer-groups'
import {
useBulkAddCustomersToGroups,
useBulkAddCustomerTags,
useBulkRemoveCustomersFromGroups,
useBulkRemoveCustomerTags,
useDeleteCustomer,
-} from '@/hooks/use-customers'
+} from '../../../../hooks/use-customers'
import {
NEW_CUSTOMER_DEFAULTS,
type NewCustomerFormValues,
newCustomerFormSchema,
-} from '@/schemas/customer'
-import '@/tables/customers'
+} from '../../../../schemas/customer'
+import '../../../../tables/customers'
// Adds `?new=1` on top of the standard table search schema so the create sheet
// is deep-linkable (`/customers?new=1`) and back-button friendly. `import`
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx
index 94c7719823..4413b9004a 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId.tsx
@@ -86,9 +86,9 @@ import { useTranslation } from 'react-i18next'
import {
CustomFieldsInlineCard,
EditableApiCustomFieldsProvider,
-} from '@/components/spree/custom-fields/custom-fields-inline'
-import { orderQueryKey, useOrder, useOrderMutation } from '@/hooks/use-order'
-import { spreeJsonLinkResolver } from '@/lib/json-link-resolver'
+} from '../../../../components/spree/custom-fields/custom-fields-inline'
+import { orderQueryKey, useOrder, useOrderMutation } from '../../../../hooks/use-order'
+import { spreeJsonLinkResolver } from '../../../../lib/json-link-resolver'
export const Route = createFileRoute('/_authenticated/$storeId/orders/$orderId')({
component: OrderDetailPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/drafts.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/drafts.tsx
index 90869f8ec2..3f588f59ae 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/drafts.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/drafts.tsx
@@ -3,7 +3,7 @@ import { Button } from '@spree/dashboard-ui'
import { createFileRoute, Link } from '@tanstack/react-router'
import { PlusIcon } from 'lucide-react'
import { useTranslation } from 'react-i18next'
-import '@/tables/orders'
+import '../../../../tables/orders'
export const Route = createFileRoute('/_authenticated/$storeId/orders/drafts')({
validateSearch: resourceSearchSchema,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/index.tsx
index b3ea521db0..d0abeb0736 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/index.tsx
@@ -7,7 +7,7 @@ import {
import { Button } from '@spree/dashboard-ui'
import { createFileRoute, Link } from '@tanstack/react-router'
import { PlusIcon } from 'lucide-react'
-import '@/tables/orders'
+import '../../../../tables/orders'
export const Route = createFileRoute('/_authenticated/$storeId/orders/')({
validateSearch: resourceSearchSchema,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx
index 02e5c12260..dba1940a13 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/new.tsx
@@ -28,10 +28,14 @@ import { TrashIcon } from 'lucide-react'
import { useState } from 'react'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { ChannelSelect } from '@/components/spree/channel-select'
-import { useChannels } from '@/hooks/use-channels'
-import { customerAutocompleteProps } from '@/hooks/use-customers'
-import { NEW_ORDER_DEFAULTS, type NewOrderFormValues, newOrderFormSchema } from '@/schemas/order'
+import { ChannelSelect } from '../../../../components/spree/channel-select'
+import { useChannels } from '../../../../hooks/use-channels'
+import { customerAutocompleteProps } from '../../../../hooks/use-customers'
+import {
+ NEW_ORDER_DEFAULTS,
+ type NewOrderFormValues,
+ newOrderFormSchema,
+} from '../../../../schemas/order'
export const Route = createFileRoute('/_authenticated/$storeId/orders/new')({
component: NewOrderPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx
index f9b2140238..6970d7dbfb 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/$productId.tsx
@@ -20,7 +20,7 @@ import { toast } from 'sonner'
import {
CustomFieldsInlineCard,
FormBackedCustomFieldsProvider,
-} from '@/components/spree/custom-fields/custom-fields-inline'
+} from '../../../../components/spree/custom-fields/custom-fields-inline'
import {
CategorizationCard,
GeneralCard,
@@ -31,17 +31,17 @@ import {
StatusCard,
TaxCard,
VariantsCard,
-} from '@/components/spree/products/product-form-cards'
-import { PublishingCard } from '@/components/spree/products/publishing-card'
-import { ResourceTranslationsCard } from '@/components/spree/translations/resource-translations-card'
-import { useDeleteProduct, useProduct, useUpdateProduct } from '@/hooks/use-product'
-import { useProductMedia } from '@/hooks/use-product-media'
-import { spreeJsonLinkResolver } from '@/lib/json-link-resolver'
+} from '../../../../components/spree/products/product-form-cards'
+import { PublishingCard } from '../../../../components/spree/products/publishing-card'
+import { ResourceTranslationsCard } from '../../../../components/spree/translations/resource-translations-card'
+import { useDeleteProduct, useProduct, useUpdateProduct } from '../../../../hooks/use-product'
+import { useProductMedia } from '../../../../hooks/use-product-media'
+import { spreeJsonLinkResolver } from '../../../../lib/json-link-resolver'
import {
type ProductFormValues,
productFormSchema,
type VariantFormValues,
-} from '@/schemas/product'
+} from '../../../../schemas/product'
// Purchasable attributes (sku, barcode, prices, weight, dimensions, stock,
// track_inventory) live on variants in API v3. The product form no longer
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/$categoryId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/$categoryId.tsx
index c9064d9e12..09f133ce77 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/$categoryId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/$categoryId.tsx
@@ -14,15 +14,22 @@ import { useEffect } from 'react'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { CategoryMain, CategorySidebar } from '@/components/spree/categories/category-form'
-import { useCategory, useDeleteCategory, useUpdateCategory } from '@/hooks/use-categories'
+import {
+ CategoryMain,
+ CategorySidebar,
+} from '../../../../../components/spree/categories/category-form'
+import {
+ useCategory,
+ useDeleteCategory,
+ useUpdateCategory,
+} from '../../../../../hooks/use-categories'
import {
CATEGORY_DEFAULTS,
type CategoryFormValues,
categoryFormSchema,
categoryToForm,
categoryToParams,
-} from '@/schemas/category'
+} from '../../../../../schemas/category'
export const Route = createFileRoute('/_authenticated/$storeId/products/categories/$categoryId')({
component: CategoryDetailPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/index.tsx
index f16c67cd9e..f6e2ede95a 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/index.tsx
@@ -13,15 +13,15 @@ import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { PlusIcon, SearchIcon } from 'lucide-react'
import { useDeferredValue, useState } from 'react'
import { useTranslation } from 'react-i18next'
-import { CategoryList } from '@/components/spree/categories/category-list'
-import { CategoryTree } from '@/components/spree/categories/category-tree'
-import { ResourceTranslationsDialog } from '@/components/spree/translations/resource-translations-dialog'
+import { CategoryList } from '../../../../../components/spree/categories/category-list'
+import { CategoryTree } from '../../../../../components/spree/categories/category-tree'
+import { ResourceTranslationsDialog } from '../../../../../components/spree/translations/resource-translations-dialog'
import {
useCategories,
useCategorySearch,
useDeleteCategory,
useRepositionCategory,
-} from '@/hooks/use-categories'
+} from '../../../../../hooks/use-categories'
export const Route = createFileRoute('/_authenticated/$storeId/products/categories/')({
component: CategoriesPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/new.tsx
index 74031230c8..1f5d014f22 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/new.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/categories/new.tsx
@@ -6,14 +6,17 @@ import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { CategoryMain, CategorySidebar } from '@/components/spree/categories/category-form'
-import { useCreateCategory } from '@/hooks/use-categories'
+import {
+ CategoryMain,
+ CategorySidebar,
+} from '../../../../../components/spree/categories/category-form'
+import { useCreateCategory } from '../../../../../hooks/use-categories'
import {
CATEGORY_DEFAULTS,
type CategoryFormValues,
categoryFormSchema,
categoryToParams,
-} from '@/schemas/category'
+} from '../../../../../schemas/category'
export const Route = createFileRoute('/_authenticated/$storeId/products/categories/new')({
component: NewCategoryPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx
index dbe682119d..af621d3c3f 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/index.tsx
@@ -38,10 +38,10 @@ import { useCallback, useMemo, useState } from 'react'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
import { z } from 'zod/v4'
-import { ImportWizardDialog } from '@/components/spree/imports/import-wizard-dialog'
-import { categoryAutocompleteProps, useCategories } from '@/hooks/use-categories'
-import { channelAutocompleteProps, useChannels } from '@/hooks/use-channels'
-import { useDeleteProduct } from '@/hooks/use-product'
+import { ImportWizardDialog } from '../../../../components/spree/imports/import-wizard-dialog'
+import { categoryAutocompleteProps, useCategories } from '../../../../hooks/use-categories'
+import { channelAutocompleteProps, useChannels } from '../../../../hooks/use-channels'
+import { useDeleteProduct } from '../../../../hooks/use-product'
import {
useBulkAddProductsToCategories,
useBulkAddProductsToChannels,
@@ -52,8 +52,8 @@ import {
useBulkRemoveProductsFromChannels,
useBulkRemoveProductTags,
useCloneProduct,
-} from '@/hooks/use-products'
-import '@/tables/products'
+} from '../../../../hooks/use-products'
+import '../../../../tables/products'
// `import` carries the prefixed id of the import whose wizard dialog is open
// over the table — deep-linkable and refresh-safe.
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/new.tsx
index c85095bca0..1e1f10c84b 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/new.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/new.tsx
@@ -9,7 +9,7 @@ import { toast } from 'sonner'
import {
CustomFieldsInlineCard,
FormBackedCustomFieldsProvider,
-} from '@/components/spree/custom-fields/custom-fields-inline'
+} from '../../../../components/spree/custom-fields/custom-fields-inline'
import {
CategorizationCard,
GeneralCard,
@@ -20,15 +20,15 @@ import {
StatusCard,
TaxCard,
VariantsCard,
-} from '@/components/spree/products/product-form-cards'
-import { PublishingCard } from '@/components/spree/products/publishing-card'
-import { useCreateProduct } from '@/hooks/use-product'
+} from '../../../../components/spree/products/product-form-cards'
+import { PublishingCard } from '../../../../components/spree/products/publishing-card'
+import { useCreateProduct } from '../../../../hooks/use-product'
import {
isPlaceholderDefaultVariant,
newProductFormDefaults,
type ProductFormValues,
productFormSchema,
-} from '@/schemas/product'
+} from '../../../../schemas/product'
import { variantToWirePayload } from './$productId'
export const Route = createFileRoute('/_authenticated/$storeId/products/new')({
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx
index b2b3a06432..44c990573a 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/options.tsx
@@ -84,13 +84,13 @@ import {
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
import { z } from 'zod/v4'
-import { ResourceTranslationsDialog } from '@/components/spree/translations/resource-translations-dialog'
+import { ResourceTranslationsDialog } from '../../../../components/spree/translations/resource-translations-dialog'
import {
useCreateOptionType,
useDeleteOptionType,
useOptionType,
useUpdateOptionType,
-} from '@/hooks/use-option-types'
+} from '../../../../hooks/use-option-types'
import {
OPTION_TYPE_DEFAULTS,
OPTION_TYPE_KINDS,
@@ -99,8 +99,8 @@ import {
optionTypeFormSchema,
optionValueToFormRow,
valueToParam,
-} from '@/schemas/option-type'
-import '@/tables/option-types'
+} from '../../../../schemas/option-type'
+import '../../../../tables/option-types'
const optionTypesSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/$priceListId/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/$priceListId/index.tsx
index ec3a6a1bbc..afe8be70f0 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/$priceListId/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/$priceListId/index.tsx
@@ -2,8 +2,12 @@ import { useConfirm } from '@spree/dashboard-ui'
import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { PriceListForm } from '@/components/spree/price-list-editors/price-list-form'
-import { useDeletePriceList, usePriceList, useUpdatePriceList } from '@/hooks/use-price-lists'
+import { PriceListForm } from '../../../../../../components/spree/price-list-editors/price-list-form'
+import {
+ useDeletePriceList,
+ usePriceList,
+ useUpdatePriceList,
+} from '../../../../../../hooks/use-price-lists'
export const Route = createFileRoute('/_authenticated/$storeId/products/price-lists/$priceListId/')(
{
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/index.tsx
index 8b6e31f8d0..9c70ec51d7 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/index.tsx
@@ -12,8 +12,8 @@ import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { PlusIcon } from 'lucide-react'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useDeletePriceList } from '@/hooks/use-price-lists'
-import '@/tables/price-lists'
+import { useDeletePriceList } from '../../../../../hooks/use-price-lists'
+import '../../../../../tables/price-lists'
export const Route = createFileRoute('/_authenticated/$storeId/products/price-lists/')({
validateSearch: resourceSearchSchema,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/new.tsx
index 9d301fc50d..757b133e90 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/new.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/price-lists/new.tsx
@@ -1,6 +1,6 @@
import { createFileRoute, useNavigate } from '@tanstack/react-router'
-import { PriceListForm } from '@/components/spree/price-list-editors/price-list-form'
-import { useCreatePriceList } from '@/hooks/use-price-lists'
+import { PriceListForm } from '../../../../../components/spree/price-list-editors/price-list-form'
+import { useCreatePriceList } from '../../../../../hooks/use-price-lists'
export const Route = createFileRoute('/_authenticated/$storeId/products/price-lists/new')({
component: NewPriceListPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/products/transfers.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/products/transfers.tsx
index 08a47f8252..77e78dcf7b 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/products/transfers.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/products/transfers.tsx
@@ -41,13 +41,13 @@ import { ArrowLeftRightIcon, EyeIcon, PlusIcon, TrashIcon } from 'lucide-react'
import { useMemo, useState } from 'react'
import { Trans, useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { useStockLocations } from '@/hooks/use-stock-locations'
+import { useStockLocations } from '../../../../hooks/use-stock-locations'
import {
useCreateStockTransfer,
useDeleteStockTransfer,
useStockTransfer,
-} from '@/hooks/use-stock-transfers'
-import '@/tables/stock-transfers'
+} from '../../../../hooks/use-stock-transfers'
+import '../../../../tables/stock-transfers'
const stockTransfersSearchSchema = resourceSearchSchema.extend({
view: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/$promotionId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/$promotionId.tsx
index 0c38440b62..ca0e71715d 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/$promotionId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/$promotionId.tsx
@@ -1,14 +1,14 @@
import { useConfirm } from '@spree/dashboard-ui'
import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { useTranslation } from 'react-i18next'
-import { PromotionForm } from '@/components/spree/promotion-editors/promotion-form'
+import { PromotionForm } from '../../../../components/spree/promotion-editors/promotion-form'
import {
useDeletePromotion,
usePromotion,
usePromotionActions,
usePromotionRules,
useUpdatePromotion,
-} from '@/hooks/use-promotions'
+} from '../../../../hooks/use-promotions'
export const Route = createFileRoute('/_authenticated/$storeId/promotions/$promotionId')({
component: EditPromotionPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx
index 844a99c00c..d1d8361ca4 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/gift-cards.tsx
@@ -35,7 +35,7 @@ import { useEffect, useRef } from 'react'
import { Controller, type UseFormReturn, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { customerAutocompleteProps } from '@/hooks/use-customers'
+import { customerAutocompleteProps } from '../../../../hooks/use-customers'
import {
listGiftCards,
useCreateGiftCard,
@@ -43,7 +43,7 @@ import {
useDeleteGiftCard,
useGiftCard,
useUpdateGiftCard,
-} from '@/hooks/use-gift-cards'
+} from '../../../../hooks/use-gift-cards'
import {
BATCH_LIMIT,
type GiftCardCreateFormValues,
@@ -53,8 +53,8 @@ import {
giftCardEditFormSchema,
giftCardEditValuesToParams,
giftCardSingleValuesToParams,
-} from '@/schemas/gift-card'
-import '@/tables/gift-cards'
+} from '../../../../schemas/gift-card'
+import '../../../../tables/gift-cards'
const giftCardsSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/index.tsx
index f2a42552d6..4a02179b9d 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/index.tsx
@@ -11,8 +11,8 @@ import { Button, RowActions, useConfirm, useRowClickBridge } from '@spree/dashbo
import { createFileRoute, useNavigate } from '@tanstack/react-router'
import { PlusIcon } from 'lucide-react'
import { useTranslation } from 'react-i18next'
-import { useDeletePromotion } from '@/hooks/use-promotions'
-import '@/tables/promotions'
+import { useDeletePromotion } from '../../../../hooks/use-promotions'
+import '../../../../tables/promotions'
export const Route = createFileRoute('/_authenticated/$storeId/promotions/')({
validateSearch: resourceSearchSchema,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/new.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/new.tsx
index 6074ad85bd..79d54a2e7b 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/promotions/new.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/promotions/new.tsx
@@ -1,6 +1,6 @@
import { createFileRoute, useNavigate } from '@tanstack/react-router'
-import { PromotionForm } from '@/components/spree/promotion-editors/promotion-form'
-import { useCreatePromotion } from '@/hooks/use-promotions'
+import { PromotionForm } from '../../../../components/spree/promotion-editors/promotion-form'
+import { useCreatePromotion } from '../../../../hooks/use-promotions'
export const Route = createFileRoute('/_authenticated/$storeId/promotions/new')({
component: NewPromotionPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx
index 8e3822a502..b18ade11a7 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx
@@ -38,8 +38,8 @@ import {
useCreateAllowedOrigin,
useDeleteAllowedOrigin,
useUpdateAllowedOrigin,
-} from '@/hooks/use-allowed-origins'
-import '@/tables/allowed-origins'
+} from '../../../../hooks/use-allowed-origins'
+import '../../../../tables/allowed-origins'
// Block paths, queries, fragments, and trailing slashes — the backend rejects
// them with `:must_be_origin_only`. Catching them client-side gives an
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx
index 3e8add1c46..b4c003cd3b 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/api-keys.tsx
@@ -74,7 +74,7 @@ import {
useDeleteApiKey,
useRevokeApiKey,
useUpdateApiKey,
-} from '@/hooks/use-api-keys'
+} from '../../../../hooks/use-api-keys'
export const Route = createFileRoute('/_authenticated/$storeId/settings/api-keys')({
component: ApiKeysSettingsPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/channels.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/channels.tsx
index cd942f98e0..70115dc4a6 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/channels.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/channels.tsx
@@ -43,7 +43,7 @@ import {
useCreateChannel,
useDeleteChannel,
useUpdateChannel,
-} from '@/hooks/use-channels'
+} from '../../../../hooks/use-channels'
import {
CHANNEL_DEFAULTS,
type ChannelFormValues,
@@ -52,8 +52,8 @@ import {
GUEST_CHECKOUT_VALUES,
ORDER_ROUTING_STRATEGY_VALUES,
STOREFRONT_ACCESS_VALUES,
-} from '@/schemas/channel'
-import '@/tables/channels'
+} from '../../../../schemas/channel'
+import '../../../../tables/channels'
const channelsSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/custom-field-definitions.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/custom-field-definitions.tsx
index 66e29567a9..0a8ecdef35 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/custom-field-definitions.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/custom-field-definitions.tsx
@@ -31,15 +31,15 @@ import { useEffect } from 'react'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { DefinitionFormFields } from '@/components/spree/custom-fields/definition-form'
+import { DefinitionFormFields } from '../../../../components/spree/custom-fields/definition-form'
import {
CUSTOM_FIELD_DEFINITION_DEFAULTS,
type CustomFieldDefinitionFormValues,
customFieldDefinitionSchema,
customFieldDefinitionValuesToCreateParams,
customFieldDefinitionValuesToUpdateParams,
-} from '@/schemas/custom-field-definition'
-import '@/tables/custom-field-definitions'
+} from '../../../../schemas/custom-field-definition'
+import '../../../../tables/custom-field-definitions'
const searchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/emails.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/emails.tsx
index ac2a7926c7..62ec757b3d 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/emails.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/emails.tsx
@@ -23,8 +23,8 @@ import { createFileRoute } from '@tanstack/react-router'
import { Controller, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useStoreSettings, useUpdateStoreSettings } from '@/hooks/use-store-settings'
-import { type StoreEmailsFormValues, storeEmailsFormSchema } from '@/schemas/store-emails'
+import { useStoreSettings, useUpdateStoreSettings } from '../../../../hooks/use-store-settings'
+import { type StoreEmailsFormValues, storeEmailsFormSchema } from '../../../../schemas/store-emails'
export const Route = createFileRoute('/_authenticated/$storeId/settings/emails')({
component: EmailSettingsPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/markets.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/markets.tsx
index cb903c60b3..d125b6c7ed 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/markets.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/markets.tsx
@@ -39,14 +39,19 @@ import { useEffect, useMemo } from 'react'
import { Controller, type UseFormReturn, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { useCreateMarket, useDeleteMarket, useMarket, useUpdateMarket } from '@/hooks/use-markets'
+import {
+ useCreateMarket,
+ useDeleteMarket,
+ useMarket,
+ useUpdateMarket,
+} from '../../../../hooks/use-markets'
import {
MARKET_DEFAULTS,
type MarketFormValues,
marketFormSchema,
marketValuesToParams,
-} from '@/schemas/market'
-import '@/tables/markets'
+} from '../../../../schemas/market'
+import '../../../../tables/markets'
const marketsSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/payment-methods.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/payment-methods.tsx
index 8720ffe6e7..bd5cc9b52b 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/payment-methods.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/payment-methods.tsx
@@ -30,15 +30,15 @@ import { useEffect, useMemo, useRef, useState } from 'react'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { PaymentMethodForm } from '@/components/spree/payment-method-editors/payment-method-form'
-import type { PaymentMethodFormValues } from '@/components/spree/payment-method-editors/types'
+import { PaymentMethodForm } from '../../../../components/spree/payment-method-editors/payment-method-form'
+import type { PaymentMethodFormValues } from '../../../../components/spree/payment-method-editors/types'
import {
useCreatePaymentMethod,
useDeletePaymentMethod,
usePaymentMethod,
usePaymentMethodTypes,
useUpdatePaymentMethod,
-} from '@/hooks/use-payment-methods'
+} from '../../../../hooks/use-payment-methods'
import {
PAYMENT_METHOD_BASE_DEFAULTS,
PAYMENT_METHOD_CREATE_DEFAULTS,
@@ -46,8 +46,8 @@ import {
paymentMethodCreateFormSchema,
paymentMethodValuesToCreateParams,
paymentMethodValuesToUpdateParams,
-} from '@/schemas/payment-method'
-import '@/tables/payment-methods'
+} from '../../../../schemas/payment-method'
+import '../../../../tables/payment-methods'
const paymentMethodsSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx
index 11afd22213..6810f12420 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/profile.tsx
@@ -40,9 +40,9 @@ import {
} from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useProfile, useUpdateProfile } from '@/hooks/use-profile'
-import { getAvailableUiLocales } from '@/i18n-setup'
-import { type MeFormValues, meFormSchema, meToForm, meToParams } from '@/schemas/me'
+import { useProfile, useUpdateProfile } from '../../../../hooks/use-profile'
+import { getAvailableUiLocales } from '../../../../i18n-setup'
+import { type MeFormValues, meFormSchema, meToForm, meToParams } from '../../../../schemas/me'
export const Route = createFileRoute('/_authenticated/$storeId/settings/profile')({
component: ProfilePage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx
index db59def6a1..2b0c1ea90e 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/staff.tsx
@@ -77,7 +77,7 @@ import {
useRoles,
useStaff,
useUpdateStaff,
-} from '@/hooks/use-staff'
+} from '../../../../hooks/use-staff'
export const Route = createFileRoute('/_authenticated/$storeId/settings/staff')({
component: StaffSettingsPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx
index e4223a8d01..75a0c60600 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/stock-locations.tsx
@@ -50,13 +50,13 @@ import { useEffect, useMemo, useState } from 'react'
import { Controller, type UseFormReturn, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { z } from 'zod/v4'
-import { useStockItems, useUpdateStockItem } from '@/hooks/use-stock-items'
+import { useStockItems, useUpdateStockItem } from '../../../../hooks/use-stock-items'
import {
useCreateStockLocation,
useDeleteStockLocation,
useStockLocation,
useUpdateStockLocation,
-} from '@/hooks/use-stock-locations'
+} from '../../../../hooks/use-stock-locations'
import {
formValuesToParams,
PICKUP_STOCK_POLICIES,
@@ -65,8 +65,8 @@ import {
type StockLocationFormValues,
stockLocationFormSchema,
stockLocationToFormValues,
-} from '@/schemas/stock-location'
-import '@/tables/stock-locations'
+} from '../../../../schemas/stock-location'
+import '../../../../tables/stock-locations'
// Adds `?edit=<id>` and `?new=1` on top of the standard table search schema
// so we can deep-link to the create / edit sheet.
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/store.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/store.tsx
index 920d2d0bac..52d590b5f4 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/store.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/store.tsx
@@ -41,15 +41,15 @@ import {
} from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
-import { useStoreSettings, useUpdateStoreSettings } from '@/hooks/use-store-settings'
-import { getAvailableUiLocales } from '@/i18n-setup'
+import { useStoreSettings, useUpdateStoreSettings } from '../../../../hooks/use-store-settings'
+import { getAvailableUiLocales } from '../../../../i18n-setup'
import {
STOREFRONT_ACCESS_LEVELS,
type StoreSettingsFormValues,
storeSettingsFormSchema,
UNIT_SYSTEMS,
WEIGHT_UNITS,
-} from '@/schemas/store'
+} from '../../../../schemas/store'
export const Route = createFileRoute('/_authenticated/$storeId/settings/store')({
component: StoreSettingsPage,
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/tax-categories.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/tax-categories.tsx
index b6ddc53dfe..8b7fad0f8e 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/tax-categories.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/tax-categories.tsx
@@ -39,14 +39,14 @@ import {
useDeleteTaxCategory,
useTaxCategory,
useUpdateTaxCategory,
-} from '@/hooks/use-tax-categories'
+} from '../../../../hooks/use-tax-categories'
import {
TAX_CATEGORY_DEFAULTS,
type TaxCategoryFormValues,
taxCategoryFormSchema,
taxCategoryValuesToParams,
-} from '@/schemas/tax-category'
-import '@/tables/tax-categories'
+} from '../../../../schemas/tax-category'
+import '../../../../tables/tax-categories'
const taxCategoriesSearchSchema = resourceSearchSchema.extend({
edit: z.string().optional(),
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx
index 4d7d6ee4bb..902f16b8c6 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/$webhookEndpointId.tsx
@@ -44,7 +44,7 @@ import { type UseFormReturn, useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
import { z } from 'zod/v4'
-import { WebhookEndpointFormFields } from '@/components/spree/webhook-endpoint-form'
+import { WebhookEndpointFormFields } from '../../../../../components/spree/webhook-endpoint-form'
import {
useDeleteWebhookEndpoint,
useRedeliverWebhookDelivery,
@@ -53,14 +53,14 @@ import {
useUpdateWebhookEndpoint,
useWebhookDelivery,
useWebhookEndpoint,
-} from '@/hooks/use-webhook-endpoints'
-import { webhookEndpointHealth, webhookHealthBadgeVariant } from '@/lib/webhook-health'
+} from '../../../../../hooks/use-webhook-endpoints'
+import { webhookEndpointHealth, webhookHealthBadgeVariant } from '../../../../../lib/webhook-health'
import {
DEFAULT_WEBHOOK_ENDPOINT_VALUES,
type WebhookEndpointFormValues,
webhookEndpointFormSchema,
-} from '@/schemas/webhook-endpoint'
-import '@/tables/webhook-deliveries'
+} from '../../../../../schemas/webhook-endpoint'
+import '../../../../../tables/webhook-deliveries'
// `<JsonValueView>` pulls in `@uiw/react-json-view` (~30 KB gzip). Lazy-loading
// it keeps the route's entry chunk small — the renderer only matters when an
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/index.tsx
index 3389507937..5e942742bd 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/settings/webhooks/index.tsx
@@ -36,19 +36,19 @@ import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
import { toast } from 'sonner'
import { z } from 'zod/v4'
-import { WebhookEndpointFormFields } from '@/components/spree/webhook-endpoint-form'
+import { WebhookEndpointFormFields } from '../../../../../components/spree/webhook-endpoint-form'
import {
useCreateWebhookEndpoint,
useDeleteWebhookEndpoint,
useSendTestWebhook,
useToggleWebhookEndpoint,
-} from '@/hooks/use-webhook-endpoints'
+} from '../../../../../hooks/use-webhook-endpoints'
import {
DEFAULT_WEBHOOK_ENDPOINT_VALUES,
type WebhookEndpointFormValues,
webhookEndpointFormSchema,
-} from '@/schemas/webhook-endpoint'
-import '@/tables/webhook-endpoints'
+} from '../../../../../schemas/webhook-endpoint'
+import '../../../../../tables/webhook-endpoints'
const webhooksSearchSchema = resourceSearchSchema.extend({
new: z.coerce.boolean().optional(),
diff --git a/packages/dashboard/src/routes/accept-invitation.$invitationId.tsx b/packages/dashboard/src/routes/accept-invitation.$invitationId.tsx
index 0ab98fcc09..9e23c96a4c 100644
--- a/packages/dashboard/src/routes/accept-invitation.$invitationId.tsx
+++ b/packages/dashboard/src/routes/accept-invitation.$invitationId.tsx
@@ -21,7 +21,7 @@ import {
type AcceptInvitationSignUpFormValues,
acceptInvitationSignInFormSchema,
acceptInvitationSignUpFormSchema,
-} from '@/schemas/auth'
+} from '../schemas/auth'
const acceptSearchSchema = z.object({
token: z.string().min(1).optional(),
diff --git a/packages/dashboard/src/routes/login.tsx b/packages/dashboard/src/routes/login.tsx
index f3c4a2569d..19818ffe16 100644
--- a/packages/dashboard/src/routes/login.tsx
+++ b/packages/dashboard/src/routes/login.tsx
@@ -13,8 +13,8 @@ import {
import { createFileRoute, Link, Navigate } from '@tanstack/react-router'
import { useForm } from 'react-hook-form'
import { useTranslation } from 'react-i18next'
-import { AuthShell } from '@/components/spree/auth-shell'
-import { type LoginFormValues, loginFormSchema } from '@/schemas/auth'
+import { AuthShell } from '../components/spree/auth-shell'
+import { type LoginFormValues, loginFormSchema } from '../schemas/auth'
export const Route = createFileRoute('/login')({
component: LoginPage,
diff --git a/packages/dashboard/src/schemas/category.ts b/packages/dashboard/src/schemas/category.ts
index 150bc489c8..afcec41c03 100644
--- a/packages/dashboard/src/schemas/category.ts
+++ b/packages/dashboard/src/schemas/category.ts
@@ -1,7 +1,7 @@
import type { Category } from '@spree/admin-sdk'
import { requiredMessage } from '@spree/dashboard-ui'
import { z } from 'zod/v4'
-import { customFieldFormSchema } from '@/schemas/product'
+import { customFieldFormSchema } from './product'
// Each image field is a small state machine: untouched (omit on save),
// uploaded (send signed_id), or cleared (send null to purge). `*_signed_id`
diff --git a/packages/dashboard/src/schemas/promotion.ts b/packages/dashboard/src/schemas/promotion.ts
index d55f43b148..3b5c2582dc 100644
--- a/packages/dashboard/src/schemas/promotion.ts
+++ b/packages/dashboard/src/schemas/promotion.ts
@@ -4,7 +4,7 @@ import { z } from 'zod/v4'
import type {
PromotionActionFormDraft,
PromotionRuleFormDraft,
-} from '@/components/spree/promotion-editors/types'
+} from '../components/spree/promotion-editors/types'
export type PromotionKind = 'coupon_code' | 'automatic'
export type MatchPolicy = 'all' | 'any'
diff --git a/packages/dashboard/src/tables/custom-field-definitions.tsx b/packages/dashboard/src/tables/custom-field-definitions.tsx
index e51b48a03b..c05c3f4310 100644
--- a/packages/dashboard/src/tables/custom-field-definitions.tsx
+++ b/packages/dashboard/src/tables/custom-field-definitions.tsx
@@ -7,7 +7,7 @@ import {
FIELD_TYPES,
fieldTypeLabel,
resourceTypeLabel,
-} from '@/schemas/custom-field-definition'
+} from '../schemas/custom-field-definition'
const t = (key: string) => i18n.t(key)
diff --git a/packages/dashboard/src/tables/customers.tsx b/packages/dashboard/src/tables/customers.tsx
index c571b359c9..092f228850 100644
--- a/packages/dashboard/src/tables/customers.tsx
+++ b/packages/dashboard/src/tables/customers.tsx
@@ -3,7 +3,7 @@ import { ActiveBadge, Badge, RelativeTime, TagList } from '@spree/dashboard-ui'
import { Link } from '@tanstack/react-router'
import i18n from 'i18next'
import { UsersIcon } from 'lucide-react'
-import { customerGroupAutocompleteProps } from '@/hooks/use-customer-groups'
+import { customerGroupAutocompleteProps } from '../hooks/use-customer-groups'
defineTable('customers', {
title: i18n.t('admin.nav.customers'),
diff --git a/packages/dashboard/src/tables/gift-cards.tsx b/packages/dashboard/src/tables/gift-cards.tsx
index 2e5afa78ed..d082d011b4 100644
--- a/packages/dashboard/src/tables/gift-cards.tsx
+++ b/packages/dashboard/src/tables/gift-cards.tsx
@@ -3,9 +3,9 @@ import { defineTable } from '@spree/dashboard-core'
import { Badge, RelativeTime, ResourceNameCell } from '@spree/dashboard-ui'
import i18n from 'i18next'
import { GiftIcon } from 'lucide-react'
-import { adminUserAutocompleteProps } from '@/hooks/use-admin-users'
-import { customerAutocompleteProps } from '@/hooks/use-customers'
-import { giftCardBatchAutocompleteProps } from '@/hooks/use-gift-cards'
+import { adminUserAutocompleteProps } from '../hooks/use-admin-users'
+import { customerAutocompleteProps } from '../hooks/use-customers'
+import { giftCardBatchAutocompleteProps } from '../hooks/use-gift-cards'
// Server `Spree::GiftCard#display_state` exposes "expired" when the card
// is past its expiration date, even though the underlying column is still
diff --git a/packages/dashboard/src/tables/orders.tsx b/packages/dashboard/src/tables/orders.tsx
index c2dec26967..20af0a09a8 100644
--- a/packages/dashboard/src/tables/orders.tsx
+++ b/packages/dashboard/src/tables/orders.tsx
@@ -3,7 +3,7 @@ import { RelativeTime, StatusBadge, TagList } from '@spree/dashboard-ui'
import { Link } from '@tanstack/react-router'
import i18n from 'i18next'
import { ShoppingCartIcon } from 'lucide-react'
-import { channelAutocompleteProps } from '@/hooks/use-channels'
+import { channelAutocompleteProps } from '../hooks/use-channels'
/**
* Localized label for an order status code, resolved from the given namespace
diff --git a/packages/dashboard/src/tables/price-lists.tsx b/packages/dashboard/src/tables/price-lists.tsx
index 366b0a9b97..eafd25d980 100644
--- a/packages/dashboard/src/tables/price-lists.tsx
+++ b/packages/dashboard/src/tables/price-lists.tsx
@@ -3,7 +3,7 @@ import { defineTable } from '@spree/dashboard-core'
import { ResourceNameCell } from '@spree/dashboard-ui'
import i18n from 'i18next'
import { TagsIcon } from 'lucide-react'
-import { PriceListStatusBadge } from '@/components/spree/price-list-editors/status-badge'
+import { PriceListStatusBadge } from '../components/spree/price-list-editors/status-badge'
defineTable<PriceList>('price-lists', {
title: i18n.t('admin.nav.price_lists'),
diff --git a/packages/dashboard/src/tables/products.tsx b/packages/dashboard/src/tables/products.tsx
index 07a153061d..18019831b8 100644
--- a/packages/dashboard/src/tables/products.tsx
+++ b/packages/dashboard/src/tables/products.tsx
@@ -4,8 +4,8 @@ import { StatusBadge, TagList } from '@spree/dashboard-ui'
import { Link } from '@tanstack/react-router'
import i18n from 'i18next'
import { PackageIcon } from 'lucide-react'
-import { categoryAutocompleteProps } from '@/hooks/use-categories'
-import { channelAutocompleteProps } from '@/hooks/use-channels'
+import { categoryAutocompleteProps } from '../hooks/use-categories'
+import { channelAutocompleteProps } from '../hooks/use-channels'
defineTable('products', {
title: i18n.t('admin.nav.products'),
diff --git a/packages/dashboard/src/tables/webhook-endpoints.tsx b/packages/dashboard/src/tables/webhook-endpoints.tsx
index a309bc18ec..123e959293 100644
--- a/packages/dashboard/src/tables/webhook-endpoints.tsx
+++ b/packages/dashboard/src/tables/webhook-endpoints.tsx
@@ -9,7 +9,7 @@ import {
} from '@spree/dashboard-ui'
import i18n from 'i18next'
import { WebhookIcon } from 'lucide-react'
-import { webhookEndpointHealth, webhookHealthBadgeVariant } from '@/lib/webhook-health'
+import { webhookEndpointHealth, webhookHealthBadgeVariant } from '../lib/webhook-health'
defineTable<WebhookEndpoint>('webhook-endpoints', {
title: i18n.t('admin.pages.settings.webhooks.title'),