override

/marmo-ui:override

Let this app customize the design system without forking it. All app code imports UI from a local wrapper folder (src/ui/, aliased as @/ui) that re-exports everything from @marmoui/ui; overriding a component means dropping a file in that folder and shadowing the package export. New app-specific components live in the same folder.

Two modes, inferred from the request:

• /marmo-ui:override DataTable — override an existing @marmoui/ui component.
• /marmo-ui:override new InvoiceCard (or any request that names a component the MCP doesn't know) — create a new custom component in the ui folder.

Follow the marmo-ui skill's MCP workflow throughout — get_knowledge_version + get_design_guidelines once per session, get_component_info for every @marmoui/ui primitive you touch, review_generated_code on the final output.

Step 1 — Ensure the wrapper exists (first run only)

Check for src/ui/index.ts (also accept src/components/ui/index.ts or an existing uiImportPath in DESIGN.md). If missing:

1. Resolve the import alias from tsconfig.json compilerOptions.paths (usually @/* → ./src/*). If no alias exists, add "@/*": ["./src/*"].

2. Create src/ui/index.ts:

   // App UI entry point. Import all UI from '@/ui', never from '@marmoui/ui' directly.
   export * from '@marmoui/ui';
   
   // Local overrides — explicit exports below shadow the package's star export.
   // export { DataTable } from './data-table';
   

3. Record the path in DESIGN.md frontmatter so every agent knows the convention: uiImportPath: "@/ui". Create a minimal DESIGN.md via /marmo-ui:init first if none exists and the user agrees; otherwise just add the key.

4. Offer (don't do silently) to migrate existing imports: replace from '@marmoui/ui' with from '@/ui' across src/ (excluding src/ui/ itself, which is the only place allowed to import the package).

ESM guarantees the shadowing: an explicit named export always wins over a name arriving via export *, so re-exporting DataTable from ./data-table overrides the package's version everywhere the app imports @/ui.