@framingui/mcp-server 0.6.26 → 0.6.27

package/dist/platform-support.d.ts

@@ -0,0 +1,22 @@
+export declare const PLATFORM_TARGETS: readonly ["web", "react-native"];
+export type PlatformTarget = (typeof PLATFORM_TARGETS)[number];
+export interface DirectWriteAuditRule {
+    id: string;
+    severity: 'warning' | 'error';
+    description: string;
+    pattern: RegExp;
+    guidance: string;
+}
+export interface PlatformSupportInfo {
+    supported: boolean;
+    recommended: boolean;
+    status: 'full' | 'partial' | 'avoid';
+    notes: string[];
+    recommendedImports: string[];
+    recommendedPackages: string[];
+}
+export declare function getSupportedPlatforms(): PlatformTarget[];
+export declare function getPlatformSupportInfo(componentName: string, platform?: PlatformTarget): PlatformSupportInfo;
+export declare function getReactNativeAuditRules(): DirectWriteAuditRule[];
+export declare function getImportStatementForPlatform(componentName: string, platform?: PlatformTarget): string;
+//# sourceMappingURL=platform-support.d.ts.map

package/dist/platform-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-support.d.ts","sourceRoot":"","sources":["../src/platform-support.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,kCAAmC,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AA2ED,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAExD;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,cAAsB,GAC/B,mBAAmB,CAqErB;AAED,wBAAgB,wBAAwB,IAAI,oBAAoB,EAAE,CAEjE;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,GAAE,cAAsB,GAC/B,MAAM,CAWR"}

package/dist/platform-support.js

@@ -0,0 +1,148 @@
+export const PLATFORM_TARGETS = ['web', 'react-native'];
+const REACT_NATIVE_SUPPORTED_COMPONENTS = new Set([
+    'Button',
+    'Input',
+    'Text',
+    'Heading',
+    'Checkbox',
+    'Radio',
+    'Switch',
+    'Slider',
+    'Badge',
+    'Avatar',
+    'Card',
+    'List',
+    'Image',
+    'Progress',
+]);
+const REACT_NATIVE_PARTIAL_COMPONENTS = new Set(['Form', 'Link']);
+const REACT_NATIVE_AVOID_COMPONENTS = new Set(['Modal', 'Tabs', 'Table', 'Dropdown']);
+const REACT_NATIVE_RECOMMENDED_PACKAGES = ['react-native', 'react-native-safe-area-context'];
+const REACT_NATIVE_RUNTIME_IMPORT_STATEMENTS = {
+    Button: "import { Button } from '@framingui/react-native';",
+    Input: "import { TextField } from '@framingui/react-native';",
+};
+const REACT_NATIVE_IMPORT_STATEMENTS = {
+    Avatar: "import { Image, View } from 'react-native';",
+    Badge: "import { Text, View } from 'react-native';",
+    Button: "import { Pressable, Text } from 'react-native';",
+    Card: "import { View } from 'react-native';",
+    Checkbox: "import { Pressable, View } from 'react-native';",
+    Form: "import { View } from 'react-native';",
+    Heading: "import { Text } from 'react-native';",
+    Image: "import { Image } from 'react-native';",
+    Input: "import { TextInput } from 'react-native';",
+    Link: "import { Pressable, Text } from 'react-native';",
+    List: "import { FlatList, View } from 'react-native';",
+    Progress: "import { View } from 'react-native';",
+    Radio: "import { Pressable, View } from 'react-native';",
+    Slider: "import { View } from 'react-native';",
+    Switch: "import { Switch } from 'react-native';",
+    Text: "import { Text } from 'react-native';",
+};
+const REACT_NATIVE_AUDIT_RULES = [
+    {
+        id: 'rn-hardcoded-color',
+        severity: 'warning',
+        description: 'Hardcoded color literal found in a React Native style object',
+        pattern: /#[0-9a-fA-F]{3,8}\b|rgba?\(/,
+        guidance: 'Replace raw colors with theme or token-backed helpers before handoff.',
+    },
+    {
+        id: 'rn-hardcoded-spacing',
+        severity: 'warning',
+        description: 'Hardcoded spacing or radius value found in a style declaration',
+        pattern: /\b(?:margin|padding|gap|top|right|bottom|left|width|height|minWidth|minHeight|maxWidth|maxHeight|borderRadius)\s*:\s*(?:[1-9]\d?|\d{3,})\b/,
+        guidance: 'Replace raw spacing and radius values with token-backed spacing helpers.',
+    },
+    {
+        id: 'rn-web-classname',
+        severity: 'error',
+        description: 'Web-only className usage found in a React Native target file',
+        pattern: /\bclassName\s*=/,
+        guidance: 'Use style/style arrays or host app abstractions instead of className in React Native.',
+    },
+];
+export function getSupportedPlatforms() {
+    return [...PLATFORM_TARGETS];
+}
+export function getPlatformSupportInfo(componentName, platform = 'web') {
+    if (platform === 'web') {
+        return {
+            supported: true,
+            recommended: true,
+            status: 'full',
+            notes: ['Use the published FramingUI React components and detected style contract.'],
+            recommendedImports: ['@framingui/ui'],
+            recommendedPackages: ['@framingui/ui'],
+        };
+    }
+    if (REACT_NATIVE_SUPPORTED_COMPONENTS.has(componentName)) {
+        const hasRuntimeExport = componentName in REACT_NATIVE_RUNTIME_IMPORT_STATEMENTS;
+        return {
+            supported: true,
+            recommended: true,
+            status: 'full',
+            notes: [
+                hasRuntimeExport
+                    ? 'Prefer the matching export from @framingui/react-native, then compose with host primitives as needed.'
+                    : 'Write this component directly using React Native primitives or existing app abstractions.',
+                'Keep FramingUI as the contract and validation layer for native direct-write.',
+            ],
+            recommendedImports: hasRuntimeExport
+                ? ['@framingui/react-native', 'react-native']
+                : ['react-native'],
+            recommendedPackages: hasRuntimeExport
+                ? ['@framingui/react-native', ...REACT_NATIVE_RECOMMENDED_PACKAGES]
+                : REACT_NATIVE_RECOMMENDED_PACKAGES,
+        };
+    }
+    if (REACT_NATIVE_PARTIAL_COMPONENTS.has(componentName)) {
+        return {
+            supported: true,
+            recommended: false,
+            status: 'partial',
+            notes: [
+                'This component needs app-specific composition in React Native.',
+                'Prefer composing from primitive building blocks instead of assuming web parity.',
+            ],
+            recommendedImports: ['react-native'],
+            recommendedPackages: REACT_NATIVE_RECOMMENDED_PACKAGES,
+        };
+    }
+    if (REACT_NATIVE_AVOID_COMPONENTS.has(componentName)) {
+        return {
+            supported: false,
+            recommended: false,
+            status: 'avoid',
+            notes: [
+                'This component depends on web-only interaction or layout assumptions in the current FramingUI catalog.',
+                'Model the UX using native navigation, bottom sheets, or app-specific abstractions instead.',
+            ],
+            recommendedImports: ['react-native'],
+            recommendedPackages: REACT_NATIVE_RECOMMENDED_PACKAGES,
+        };
+    }
+    return {
+        supported: false,
+        recommended: false,
+        status: 'avoid',
+        notes: ['No React Native contract is defined yet for this component.'],
+        recommendedImports: ['react-native'],
+        recommendedPackages: REACT_NATIVE_RECOMMENDED_PACKAGES,
+    };
+}
+export function getReactNativeAuditRules() {
+    return [...REACT_NATIVE_AUDIT_RULES];
+}
+export function getImportStatementForPlatform(componentName, platform = 'web') {
+    if (platform === 'web') {
+        return `import { ${componentName} } from '@framingui/ui';`;
+    }
+    const runtimeImport = REACT_NATIVE_RUNTIME_IMPORT_STATEMENTS[componentName];
+    if (runtimeImport) {
+        return runtimeImport;
+    }
+    return REACT_NATIVE_IMPORT_STATEMENTS[componentName] || "import { View } from 'react-native';";
+}
+//# sourceMappingURL=platform-support.js.map

package/dist/platform-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-support.js","sourceRoot":"","sources":["../src/platform-support.ts"],"names":[],"mappings":"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"}

package/dist/project-context-resolution.d.ts

@@ -0,0 +1,7 @@
+import type { PlatformTarget } from './schemas/mcp-schemas.js';
+export interface ResolvedPlatformTarget {
+    platform: PlatformTarget;
+    source: 'explicit' | 'session-default' | 'legacy-fallback';
+}
+export declare function resolvePlatformTarget(explicitPlatform?: PlatformTarget): ResolvedPlatformTarget;
+//# sourceMappingURL=project-context-resolution.d.ts.map

package/dist/project-context-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-resolution.d.ts","sourceRoot":"","sources":["../src/project-context-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;CAC5D;AAED,wBAAgB,qBAAqB,CAAC,gBAAgB,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAoB/F"}

package/dist/project-context-resolution.js

@@ -0,0 +1,21 @@
+import { getActiveProjectContext } from './project-context-state.js';
+export function resolvePlatformTarget(explicitPlatform) {
+    if (explicitPlatform) {
+        return {
+            platform: explicitPlatform,
+            source: 'explicit',
+        };
+    }
+    const activeProjectContext = getActiveProjectContext();
+    if (activeProjectContext) {
+        return {
+            platform: activeProjectContext.platform,
+            source: 'session-default',
+        };
+    }
+    return {
+        platform: 'web',
+        source: 'legacy-fallback',
+    };
+}
+//# sourceMappingURL=project-context-resolution.js.map

package/dist/project-context-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-resolution.js","sourceRoot":"","sources":["../src/project-context-resolution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAOrE,MAAM,UAAU,qBAAqB,CAAC,gBAAiC;IACrE,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,oBAAoB,GAAG,uBAAuB,EAAE,CAAC;IACvD,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,oBAAoB,CAAC,QAAQ;YACvC,MAAM,EAAE,iBAAiB;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,iBAAiB;KAC1B,CAAC;AACJ,CAAC"}

package/dist/project-context-state.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformTarget, ProjectEnvironment } from './schemas/mcp-schemas.js';
+export interface ActiveProjectContext {
+    projectPath: string;
+    packageJsonPath: string;
+    platform: PlatformTarget;
+    environment: ProjectEnvironment;
+    detectedAt: string;
+}
+export declare function setActiveProjectContext(context: Omit<ActiveProjectContext, 'detectedAt'>): void;
+export declare function getActiveProjectContext(): ActiveProjectContext | null;
+export declare function clearActiveProjectContext(): void;
+//# sourceMappingURL=project-context-state.d.ts.map

package/dist/project-context-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-state.d.ts","sourceRoot":"","sources":["../src/project-context-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,GAAG,IAAI,CAK/F;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,IAAI,CAErE;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/project-context-state.js

@@ -0,0 +1,14 @@
+let activeProjectContext = null;
+export function setActiveProjectContext(context) {
+    activeProjectContext = {
+        ...context,
+        detectedAt: new Date().toISOString(),
+    };
+}
+export function getActiveProjectContext() {
+    return activeProjectContext;
+}
+export function clearActiveProjectContext() {
+    activeProjectContext = null;
+}
+//# sourceMappingURL=project-context-state.js.map

package/dist/project-context-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-state.js","sourceRoot":"","sources":["../src/project-context-state.ts"],"names":[],"mappings":"AAUA,IAAI,oBAAoB,GAAgC,IAAI,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,OAAiD;IACvF,oBAAoB,GAAG;QACrB,GAAG,OAAO;QACV,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,oBAAoB,GAAG,IAAI,CAAC;AAC9B,CAAC"}

package/dist/project-context.d.ts

@@ -0,0 +1,15 @@
+import type { PackageManager, PlatformTarget, ProjectEnvironment } from './schemas/mcp-schemas.js';
+export interface DetectedProjectContext {
+    projectPath: string;
+    packageJsonPath: string;
+    platform: PlatformTarget;
+    environment: ProjectEnvironment;
+}
+export interface DetectProjectContextResult {
+    success: boolean;
+    context?: DetectedProjectContext;
+    error?: string;
+}
+export declare function detectProjectContext(projectPath: string): DetectProjectContextResult;
+export declare function detectPackageManager(projectPath: string, packageManagerField?: string): PackageManager;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInG,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,CAoCpF;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,cAAc,CAgChB"}

package/dist/project-context.js

@@ -0,0 +1,78 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readPackageJson } from './utils/package-json-reader.js';
+const EXPO_CONFIG_CANDIDATES = ['app.json', 'app.config.js', 'app.config.ts', 'app.config.mjs'];
+export function detectProjectContext(projectPath) {
+    const readResult = readPackageJson(projectPath);
+    if (!readResult.success || !readResult.packageJson || !readResult.installedPackages) {
+        return {
+            success: false,
+            error: readResult.error || 'Failed to read package.json',
+        };
+    }
+    const rootPath = projectPath.endsWith('package.json') ? path.dirname(projectPath) : projectPath;
+    const resolvedRootPath = path.resolve(rootPath);
+    const packageJsonPath = path.resolve(projectPath.endsWith('package.json') ? projectPath : path.join(rootPath, 'package.json'));
+    const installedPackages = readResult.installedPackages;
+    const runtime = detectRuntime(resolvedRootPath, installedPackages);
+    return {
+        success: true,
+        context: {
+            projectPath: resolvedRootPath,
+            packageJsonPath,
+            platform: runtime === 'web' ? 'web' : 'react-native',
+            environment: {
+                runtime,
+                projectType: runtime,
+                packageManager: detectPackageManager(resolvedRootPath, typeof readResult.packageJson.packageManager === 'string'
+                    ? readResult.packageJson.packageManager
+                    : undefined),
+            },
+        },
+    };
+}
+export function detectPackageManager(projectPath, packageManagerField) {
+    if (packageManagerField) {
+        if (packageManagerField.startsWith('pnpm')) {
+            return 'pnpm';
+        }
+        if (packageManagerField.startsWith('yarn')) {
+            return 'yarn';
+        }
+        if (packageManagerField.startsWith('bun')) {
+            return 'bun';
+        }
+        if (packageManagerField.startsWith('npm')) {
+            return 'npm';
+        }
+    }
+    if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
+        return 'pnpm';
+    }
+    if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
+        return 'yarn';
+    }
+    if (fs.existsSync(path.join(projectPath, 'bun.lock')) ||
+        fs.existsSync(path.join(projectPath, 'bun.lockb'))) {
+        return 'bun';
+    }
+    if (fs.existsSync(path.join(projectPath, 'package-lock.json'))) {
+        return 'npm';
+    }
+    return 'unknown';
+}
+function detectRuntime(projectPath, installedPackages) {
+    const hasExpoDependency = Boolean(installedPackages.expo);
+    const hasReactNativeDependency = Boolean(installedPackages['react-native']);
+    const hasExpoConfig = EXPO_CONFIG_CANDIDATES.some(fileName => fs.existsSync(path.join(projectPath, fileName)));
+    const hasNativeFolders = fs.existsSync(path.join(projectPath, 'ios')) ||
+        fs.existsSync(path.join(projectPath, 'android'));
+    if (hasExpoDependency || hasExpoConfig) {
+        return 'expo';
+    }
+    if (hasReactNativeDependency || hasNativeFolders) {
+        return 'react-native';
+    }
+    return 'web';
+}
+//# sourceMappingURL=project-context.js.map

package/dist/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../src/project-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAehG,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;QACpF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,6BAA6B;SACzD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAChG,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAClC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CACzF,CAAC;IACF,MAAM,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,CAAC;IACvD,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAEnE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,WAAW,EAAE,gBAAgB;YAC7B,eAAe;YACf,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc;YACpD,WAAW,EAAE;gBACX,OAAO;gBACP,WAAW,EAAE,OAAO;gBACpB,cAAc,EAAE,oBAAoB,CAClC,gBAAgB,EAChB,OAAO,UAAU,CAAC,WAAW,CAAC,cAAc,KAAK,QAAQ;oBACvD,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,cAAc;oBACvC,CAAC,CAAC,SAAS,CACd;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,mBAA4B;IAE5B,IAAI,mBAAmB,EAAE,CAAC;QACxB,IAAI,mBAAmB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,mBAAmB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAClD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CACpB,WAAmB,EACnB,iBAAyC;IAEzC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC3D,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAChD,CAAC;IACF,MAAM,gBAAgB,GACpB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnD,IAAI,iBAAiB,IAAI,aAAa,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,wBAAwB,IAAI,gBAAgB,EAAE,CAAC;QACjD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/prompts/getting-started.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;EA2GtC"}
+{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;EA+HtC"}

package/dist/prompts/getting-started.js

@@ -67,7 +67,19 @@ You can call \`list-themes\` and \`preview-theme\` directly after authentication
 - pebble - Round minimal
 - square-minimalism - Square minimalism
 
-## Step 4: Check Component Availability
+## Step 4: Bootstrap Project Context
+
+If the project path is known, call \`detect-project-context\` before the main workflow.
+
+\`\`\`
+1. Call detect-project-context with the project root or package.json path
+2. Let FramingUI store the detected default platform/runtime for the session
+3. Continue with discovery tools without repeating platform flags unless overriding on purpose
+\`\`\`
+
+For Expo / React Native targets, this is the preferred path. If no project path is available, you can still pass \`platform: "react-native"\` explicitly as a fallback.
+
+## Step 5: Check Component Availability
 
 Before creating screen definitions:
 
@@ -77,19 +89,26 @@ Before creating screen definitions:
 3. Identify components needed for your screen
 \`\`\`
 
-## Step 5: Generate Your First Screen
+## Step 6: Generate Your First Screen
 
 Follow the 3-step workflow:
 
 **Step 1/3:** Call \`get-screen-generation-context\` with your screen description
 - Returns: Template hints, component suggestions with inline props, schema
 - Use \`includeExamples: false\` when you want a smaller response and do not need sample screen definitions
+- If \`detect-project-context\` already ran, omit \`platform\` and let the stored default apply
 
 **Step 2/3:** Create Screen Definition JSON, then call \`validate-screen-definition\`
 - Returns: Validation results, errors with auto-fix patches, suggestions
 
 **After validation passes:** Write React code directly using the components and props from Step 1
 
+For Expo / React Native targets:
+- use the direct-write guidance from \`get-screen-generation-context\`
+- prefer \`@framingui/react-native\` exports where that runtime surface exists
+- do **not** import \`@framingui/ui\`
+- run \`validate-environment\` with \`sourceFiles\` before handoff
+
 **Step 3/3 (Optional):** Call \`validate-environment\` with project path
 - Returns: Missing packages, install commands, Tailwind config status
 
@@ -98,11 +117,12 @@ Follow the 3-step workflow:
 1. ❌ Skipping authentication - All themes require licenses
 2. ❌ Assuming whoami is a hard prerequisite - it is optional session inspection, not a hidden unlock step
 3. ❌ Using non-existent theme IDs - Only 6 themes exist
-4. ❌ Skipping validate-screen-definition - Always validate before writing code
-5. ❌ Ignoring dependencies warnings - Check required packages before running code
-6. ❌ Using unlicensed themes - Only use themes from whoami licensedThemes list
-7. ❌ Parsing MCP transcript text with shell/python/json tools - Use tool output directly instead
-8. ❌ Treating templateMatch as the source of truth - components and preview tools are the contract
+4. ❌ Skipping detect-project-context when the project path is known - you lose automatic platform defaults
+5. ❌ Skipping validate-screen-definition for web work - Always validate before writing code
+6. ❌ Ignoring dependencies warnings - Check required packages before running code
+7. ❌ Using unlicensed themes - Only use themes from whoami licensedThemes list
+8. ❌ Parsing MCP transcript text with shell/python/json tools - Use tool output directly instead
+9. ❌ Treating templateMatch as the source of truth - components and preview tools are the contract
 
 ## Need Help?
 

package/dist/prompts/getting-started.js.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.js","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEA+FkD;iBACzD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"getting-started.js","sourceRoot":"","sources":["../../src/prompts/getting-started.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kEAmHkD;iBACzD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/screen-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,uBAAuB;;;;;;;;EAuJtC"}
+{"version":3,"file":"screen-workflow.d.ts","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,uBAAuB;;;;;;;;EA0MtC"}

package/dist/prompts/screen-workflow.js

@@ -24,10 +24,29 @@ The production workflow is **guarded direct write**:
 - ✅ Write React code directly using FramingUI components and props from context
 - ✅ Verify dependencies, Tailwind setup, and raw HTML/style escapes before delivery
 
+React Native is also supported through a **direct-write contract path**:
+- ✅ Prefer \`detect-project-context\` once when the project path is known
+- ✅ Gather platform-aware component guidance without repeating platform flags
+- ✅ Write Expo / React Native code directly using \`@framingui/react-native\` where available, then host primitives or app abstractions for the rest
+- ✅ Use \`validate-environment\` with \`sourceFiles\` for package checks and QC
+- 🚫 Do not import \`@framingui/ui\` into React Native projects
+
 This is **not** the old \`generate_screen\`-first workflow.
 \`generate_screen\` may still be used as an optional helper, but the default production path is:
 
-\`preview-theme\` → \`get-screen-generation-context\` → \`preview-component\` / \`list-icon-libraries\` when needed → \`validate-screen-definition\` → write code directly → \`validate-environment\`
+If the project path is known:
+
+\`detect-project-context\` → \`preview-theme\` → \`get-screen-generation-context\` → \`preview-component\` / \`list-icon-libraries\` when needed → \`validate-screen-definition\` → write code directly → \`validate-environment\`
+
+If the project path is not known, start at \`get-screen-generation-context\` and use explicit platform overrides only when needed.
+
+## React Native Note
+
+For Expo or React Native projects:
+- pass \`"platform": "react-native"\` to \`get-screen-generation-context\`
+- prefer \`@framingui/react-native\` exports over app-local wrappers for common UI
+- write code directly with \`StyleSheet.create\`
+- run \`validate-environment\` with \`sourceFiles\` to catch web-only imports, \`className\`, and raw token drift
 
 ## Step 1/4: Gather Context
 
@@ -46,6 +65,15 @@ Use this at the start of every screen task.
 
 Set \`includeExamples: false\` when you want a smaller response and do not need example screen definitions.
 
+For React Native direct-write work without a detected session default, pass:
+\`\`\`json
+{
+  "description": "Profile screen with subscription card and settings actions",
+  "platform": "react-native",
+  "includeExamples": false
+}
+\`\`\`
+
 **What to review from the response:**
 - \`templateMatch\` as a layout hint only
 - \`components\` as the source of truth for imports, props, and variants
@@ -136,15 +164,38 @@ Use it to verify:
 
 If the tool reports missing setup or raw primitive drift, fix the code before delivery.
 
+## React Native Direct-Write Path
+
+Use this instead of the web screen-definition path when the target app is Expo or React Native.
+
+1. Call \`detect-project-context\` with \`projectPath\` when the app path is available
+2. Call \`get-screen-generation-context\` and let the stored session default pick React Native automatically
+3. If the project path is not available, call \`get-screen-generation-context\` with \`platform: "react-native"\`
+4. Review React Native compatible components and hints
+5. Write the screen directly using \`@framingui/react-native\` exports where available, then \`react-native\` primitives or local app abstractions
+6. Run \`validate-environment\` with:
+   - \`platform: "react-native"\`
+   - \`projectPath\`
+   - \`requiredPackages\`
+   - \`sourceFiles\`
+7. Fix missing packages, hardcoded color/spacing/radius values, and web-only patterns such as \`className\`
+
+React Native rules:
+- Do **not** import \`@framingui/ui\`
+- Do **not** require Tailwind or CSS imports
+- Prefer \`StyleSheet\` plus \`@framingui/react-native\` helpers or host app token helpers over raw style literals
+- Treat \`@framingui/react-native\` as a minimal runtime, not as full \`@framingui/ui\` parity or code generation
+
 ## Best Practices
 
-1. Start with \`get-screen-generation-context\`
+1. Start with \`detect-project-context\` when project path is known
 2. Use \`includeExamples: false\` unless examples are actually needed
 3. Treat \`templateMatch\` as a hint, not a hard constraint
 4. Treat \`components\` as the source of truth
 5. Validate the definition before writing JSX
 6. Never parse MCP transcript text with shell or Python JSON tooling
 7. Run \`validate-environment\` before handoff
+8. Use the React Native direct-write path when the target project is Expo or React Native
 
 ## Optional Helper Path
 

package/dist/prompts/screen-workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen-workflow.js","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gMA2IgL;iBACvL;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"screen-workflow.js","sourceRoot":"","sources":["../../src/prompts/screen-workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,uBAAuB;IACrC,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gMA8LgL;iBACvL;aACF;SACF;KACF,CAAC;AACJ,CAAC"}