@revenexx/studio-commerce

@revenexx/studio-commerce

The revenexx Commerce Studio — the manifest-driven AppRenderer (list / detail / form / widget views over installed apps) as a distributable Nuxt module. Registers its /commerce/* pages, AppRenderer/* components and composables. Data/auth flow through the usePlatformAuth / usePlatformTenant seam (from @revenexx/studio-shared).

To just preview an app locally (render a cockpit.json with mock data), use @revenexx/studio-commerce-devkit instead — it wraps this module with a ready-to-run commerce-studio bin. This package is for embedding the renderer in your own Nuxt app.

Install

Public on npm — no registry config or token needed:

pnpm add @revenexx/studio-commerce @revenexx/studio-shared @revenexx/studio

Use

// nuxt.config.ts
export default defineNuxtConfig({
  extends: ['@revenexx/studio-shared'],
  modules: ['@solar-icons/nuxt', '@revenexx/studio-commerce'],
})

Manifests come from Console (NUXT_PUBLIC_CONSOLE_API → useInstalledApps) and entity data from PostgREST (NUXT_PUBLIC_POSTGREST_API → usePostgrest); override those endpoints to point at local shims for offline/mock rendering.

⚠️ Tailwind: you MUST scan this package

The module ships its runtime as source-ish .vue; Tailwind generates the classes from your build. Scan both this module and studio-shared, or component styling silently breaks:

@import "tailwindcss";
@import "@revenexx/studio/tokens";
@import "@revenexx/studio/fonts";
@source "../node_modules/@revenexx/studio-shared/components";
@source "../node_modules/@revenexx/studio-commerce/dist/runtime";

Adjust the relative paths to reach node_modules from your CSS file.

Peers

@revenexx/studio, @revenexx/studio-shared, nuxt ^4, vue ^3.5; register @solar-icons/nuxt in the host. Media picker + Baseline-IO are seam-stubbed unless the host provides useCommerceIo / a media picker.