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.

2.5 KB
Raw Blame

@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:

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