@prado/store-engine (0.0.2)
Installation
About this package
@prado/store-engine
The shared, versioned engine behind every white-label store (see
docs/STORE_ENGINE_PLAN.md). One brand per deployment; stores depend on a
semver range and override only their skin.
Status: Phase 0 (skeleton)
Currently exports the self-contained brand-config contract and theming:
import { brandThemeCss, type BrandConfig, type ColorScale } from "@prado/store-engine";
Later phases move the resolver, font registry, page components, and API route
handlers here (Phase 1 extraction), plus the Zod-validated schemaVersion
contract (Phase 4).
Consumption
The package ships TypeScript source; Next.js consumers must transpile it:
// next.config.ts
transpilePackages: ["@prado/store-engine"]
In this monorepo it is linked as a workspace (workspace:*), so no registry
access is needed for local development. Publishing targets the Forgejo npm
registry under the @prado scope (see root .npmrc).
Build
bun run build emits dist/ (JS + d.ts) via tsconfig.build.json. Shipping
compiled artifacts instead of source is a Phase 4 hardening step.
Dependencies
Dependencies
| ID | Version |
|---|---|
| @dnd-kit/core | ^6.3.1 |
| @dnd-kit/sortable | ^10.0.0 |
| @dnd-kit/utilities | ^3.2.2 |
| @openobserve/browser-logs | ^0.3.1 |
| @openobserve/browser-rum | ^0.3.1 |
| @types/qrcode | ^1.5.6 |
| bcryptjs | ^3.0.3 |
| cheerio | ^1.2.0 |
| class-variance-authority | ^0.7.1 |
| clsx | ^2.1.1 |
| date-fns | ^4.4.0 |
| lucide-react | ^1.21.0 |
| playwright | ^1.61.1 |
| qrcode | ^1.5.4 |
| radix-ui | ^1.6.0 |
| socket.io-client | ^4.8.3 |
| tailwind-merge | ^3.6.0 |
Development dependencies
| ID | Version |
|---|---|
| @electric-sql/pglite | ^0.5.3 |
| @react-pdf/renderer | ^4.5.1 |
| @testing-library/react | ^16.3.2 |
| @types/bcryptjs | ^3.0.0 |
| @types/bun | latest |
| @types/node | ^24 |
| @types/react | ^19.2.17 |
| @types/react-dom | ^19.2.3 |
| drizzle-orm | ^0.45.2 |
| next-auth | ^5.0.0-beta.30 |
| postgres | ^3.4.9 |
| socket.io | ^4.8.3 |
| stripe | ^22.3.0 |
| zod | ^4.4.3 |
Peer dependencies
| ID | Version |
|---|---|
| @react-pdf/renderer | ^4.5.1 |
| drizzle-orm | ^0.45.2 |
| next | ^16 |
| next-auth | ^5.0.0-beta.30 |
| postgres | ^3.4.9 |
| react | ^19 |
| socket.io | ^4.8.3 |
| stripe | ^22.3.0 |
| zod | ^4.4.3 |