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.
@spree/dashboard
The Spree Commerce admin dashboard (the "React Dashboard") — a React single-page application that replaces the Classic Admin (the server-rendered Rails engine). Built on the Admin API via @spree/admin-sdk, with an extension model (nav, slots, tables, typed plugin routes) for plugin authors.
Part of the three-package dashboard stack with @spree/dashboard-core (the framework and extension API) and @spree/dashboard-ui (the design system).
The React Dashboard is the default admin from Spree 6.0. @spree/dashboard is released with Spree and carries its version: @spree/[email protected] works with Spree 6.0.x.
Tech stack
Vite · TanStack Router (file-based, type-safe) · TanStack Query · React Hook Form + Zod · shadcn/ui + Base UI + Tailwind CSS · lucide-react · Recharts · Tiptap · Sonner · Biome.
Using it
Don't wire this package by hand — scaffold a host app, which pins the stack and configures the Vite integration (@spree/dashboard/vite) for you:
# in a create-spree-app project (or pass --react-dashboard at create time)
spree add dashboard
The host consumes the exported <Dashboard /> shell and createDashboardRouter, activates any installed dashboard plugins through auto-discovery, and composes their file routes into one typed route tree.
Documentation
The full guides live on the docs site — this README intentionally stays short:
- Overview & concepts — architecture, auth, permissions, multi-store
- Customization — your pages, nav, slots, tables, translations
- Plugins — build and distribute dashboard extensions
- Deployment — served by the Spree server at
/dashboard(default) or a CDN - Public API
Contributing
The dashboard lives in the spree/spree monorepo under packages/dashboard — see the repository docs (CLAUDE.md) for local development against a Spree backend and the Playwright E2E suite.
License
MIT