viewgate-mcp 1.0.52 → 1.0.53

package/dist/index.js

@@ -429,6 +429,17 @@ function createMcpServer(apiKey, personalKey) {
                         'mui': 'Material UI / MUI v5 (use @mui/material components and sx prop for styling; avoid raw CSS)',
                     };
                     const styleLabel = styleHandlerLabels[styleHandler] ?? styleHandler;
+                    // Per-handler theming guidance so the LLM generates theme-aware components
+                    const themingByHandler = {
+                        'css': `Use CSS custom properties for all colors. Read theme values like: const primary = theme?.primary || 'var(--vg-primary)'. Apply them inline or inject a <style> block using these variables. Never hardcode colors.`,
+                        'sass': `Use CSS custom properties as values. Resolve theme at runtime: const primary = theme?.primary || 'var(--vg-primary)'. Apply via inline style or injected <style>.`,
+                        'css-modules': `CSS Modules can use CSS vars. In JS: const primary = theme?.primary || 'var(--vg-primary)'. Pass primary as CSS var via style={{ '--component-primary': primary }} on the root element and reference it inside the .module.css.`,
+                        'tailwind': `Use Tailwind's arbitrary value syntax for theme colors: className={\`bg-[\${theme?.primary || 'var(--vg-primary)'}]\`}. For text and borders follow the same pattern. Never use fixed Tailwind color classes like text-blue-500.`,
+                        'css-in-js': `In styled-components template literals, read the theme prop: color: \${({ theme: t }) => t?.primary || 'var(--vg-primary)'}. Accept the full theme object via props and propagate it through styled-components ThemeProvider if needed.`,
+                        'bootstrap': `Override Bootstrap CSS vars on the root element: style={{ '--bs-primary': theme?.primary || 'var(--vg-primary)' }}. Use btn-primary, text-primary etc. classes which will inherit the overridden variable.`,
+                        'mui': `Use createTheme({ palette: { primary: { main: theme?.primary || 'var(--vg-primary)' } } }) inside the component and wrap with ThemeProvider. Accept the theme prop and recreate the MUI theme from it.`,
+                    };
+                    const themingInstruction = themingByHandler[styleHandler] ?? themingByHandler['css'];
                     const fetchUrl = new URL(`${BACKEND_URL}/api/mcp/components`);
                     fetchUrl.searchParams.append("limit", limit.toString());
                     fetchUrl.searchParams.append("status", "pending");
@@ -465,6 +476,28 @@ function createMcpServer(apiKey, personalKey) {
                                 handler: styleHandler,
                                 instruction: `You MUST use ${styleLabel} for ALL styling. Do not mix or use any other styling approach. The component must be fully styled using this technology and be production-ready.`
                             },
+                            themingTokens: {
+                                description: 'The component MUST accept an optional `theme` prop for color customization. This is the primary mechanism for users to apply their own brand colors via a JSON file in their project.',
+                                propInterface: {
+                                    primary: 'string — main brand/accent color (buttons, links, active states)',
+                                    primaryHover: 'string — hover state of primary, slightly darker',
+                                    primaryLight: 'string — light tint of primary for backgrounds (10% opacity)',
+                                    surface: 'string — card/panel background color',
+                                    surfaceAlt: 'string — alternative surface for inputs/hover states',
+                                    border: 'string — border and divider color',
+                                    text: 'string — primary text color',
+                                    textMuted: 'string — secondary/muted text color',
+                                    radius: 'string — base border radius (e.g. "8px", "12px")',
+                                },
+                                fallbackMechanism: 'When theme prop is not provided, fall back to CSS custom properties: var(--vg-primary), var(--vg-surface), etc. This allows the ViewGate dashboard preview (which injects CSS vars) and custom ThemeProviders to work without explicit props.',
+                                handlerSpecificInstruction: themingInstruction,
+                                criticalRules: [
+                                    'NEVER hardcode any color value (no #hex, no rgb(), no named colors like blue/red)',
+                                    'ALWAYS prefer theme prop values first, then var(--vg-*) CSS vars as fallback',
+                                    'The theme prop must be optional — component must work without it using CSS var fallbacks',
+                                    'Expose the theme prop explicitly in the component TypeScript/PropTypes interface',
+                                ]
+                            },
                             constraints: {
                                 mustBeFunctional: true,
                                 mustSupportRequiredProps: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viewgate-mcp",
-  "version": "1.0.52",
+  "version": "1.0.53",
   "main": "dist/index.js",
   "bin": {
     "viewgate-mcp": "./dist/index.js"