mobile-best-practices 1.0.0

package/dist/commands/init.js

@@ -0,0 +1,94 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { SUPPORTED_PLATFORMS } from '../types/index.js';
+import { installForPlatform } from '../utils/index.js';
+export async function initCommand(options) {
+    let aiPlatform = options.ai;
+    let mobilePlatform = options.platform;
+    if (!aiPlatform) {
+        const response = await prompts({
+            type: 'select',
+            name: 'platform',
+            message: 'Which AI assistant are you using?',
+            choices: [
+                { title: 'Claude Code', value: 'claude' },
+                { title: 'Cursor', value: 'cursor' },
+                { title: 'Windsurf', value: 'windsurf' },
+                { title: 'GitHub Copilot', value: 'copilot' },
+                { title: 'Kiro', value: 'kiro' },
+                { title: 'Codex CLI', value: 'codex' },
+                { title: 'Gemini CLI', value: 'gemini' },
+                { title: 'Roo Code', value: 'roocode' },
+                { title: 'Continue', value: 'continue' },
+                { title: 'OpenCode', value: 'opencode' },
+                { title: 'Qoder', value: 'qoder' },
+                { title: 'CodeBuddy', value: 'codebuddy' },
+                { title: 'Trae', value: 'trae' },
+                { title: 'Antigravity', value: 'antigravity' },
+                { title: 'All assistants', value: 'all' },
+            ],
+        });
+        if (!response.platform) {
+            console.log(chalk.yellow('Installation cancelled.'));
+            return;
+        }
+        aiPlatform = response.platform;
+    }
+    if (!mobilePlatform) {
+        const response = await prompts({
+            type: 'select',
+            name: 'mobilePlatform',
+            message: 'Which mobile platform are you building for?',
+            choices: [
+                { title: 'Android (Jetpack Compose)', value: 'android' },
+                { title: 'iOS (SwiftUI)', value: 'ios' },
+                { title: 'Flutter (Dart)', value: 'flutter' },
+                { title: 'React Native (TypeScript)', value: 'react-native' },
+                { title: 'All platforms', value: 'all' },
+            ],
+        });
+        if (!response.mobilePlatform) {
+            console.log(chalk.yellow('Installation cancelled.'));
+            return;
+        }
+        mobilePlatform = response.mobilePlatform;
+    }
+    const projectDir = process.cwd();
+    const aiPlatforms = aiPlatform === 'all' ? SUPPORTED_PLATFORMS : [aiPlatform];
+    for (const p of aiPlatforms) {
+        const spinner = ora(`Installing for ${chalk.cyan(p)} (${chalk.dim(mobilePlatform)})...`).start();
+        try {
+            installForPlatform(p, projectDir, mobilePlatform);
+            spinner.succeed(`Installed for ${chalk.green(p)} (${mobilePlatform})`);
+        }
+        catch (error) {
+            spinner.fail(`Failed for ${chalk.red(p)}: ${error.message}`);
+        }
+    }
+    console.log();
+    console.log(chalk.green('Mobile Best Practices skill installed successfully!'));
+    console.log(chalk.dim(`Platform: ${mobilePlatform}`));
+    console.log();
+    console.log(chalk.dim('Usage:'));
+    if (aiPlatform === 'claude' || aiPlatform === 'all') {
+        console.log(chalk.dim('  Just chat naturally with Claude Code:'));
+        if (mobilePlatform === 'android') {
+            console.log(chalk.white('  "Build a product list screen with Compose"'));
+        }
+        else if (mobilePlatform === 'ios') {
+            console.log(chalk.white('  "Build a settings screen with SwiftUI"'));
+        }
+        else if (mobilePlatform === 'flutter') {
+            console.log(chalk.white('  "Build a product list with BLoC"'));
+        }
+        else if (mobilePlatform === 'react-native') {
+            console.log(chalk.white('  "Build a product list with React Navigation"'));
+        }
+        else {
+            console.log(chalk.white('  "Build a product list screen for my e-commerce app"'));
+        }
+    }
+    console.log();
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,2 @@
+export declare function updateCommand(): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAGA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BnD"}

package/dist/commands/update.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import ora from 'ora';
+export async function updateCommand() {
+    const spinner = ora('Checking for updates...').start();
+    try {
+        // Check npm for latest version
+        const response = await fetch('https://registry.npmjs.org/mobile-best-practices/latest');
+        if (!response.ok) {
+            spinner.info('Package not yet published to npm. Run locally with: npm link');
+            return;
+        }
+        const data = await response.json();
+        const { version: localVersion } = await import('../../package.json', { with: { type: 'json' } });
+        if (data.version === localVersion) {
+            spinner.succeed(`Already on latest version: ${chalk.green(localVersion)}`);
+        }
+        else {
+            spinner.info(`Update available: ${chalk.yellow(localVersion)} -> ${chalk.green(data.version)}`);
+            console.log();
+            console.log(chalk.dim('  Run to update:'));
+            console.log(chalk.white('  npm install -g mobile-best-practices@latest'));
+        }
+    }
+    catch {
+        spinner.warn('Could not check for updates. Using local version.');
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEvD,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAExF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAEjG,IAAI,IAAI,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO,CAAC,OAAO,CAAC,8BAA8B,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChG,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/commands/versions.d.ts

@@ -0,0 +1,2 @@
+export declare function versionsCommand(): void;
+//# sourceMappingURL=versions.d.ts.map

package/dist/commands/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/commands/versions.ts"],"names":[],"mappings":"AAsBA,wBAAgB,eAAe,IAAI,IAAI,CAUtC"}

package/dist/commands/versions.js

@@ -0,0 +1,30 @@
+import chalk from 'chalk';
+const VERSIONS = [
+    {
+        version: '1.0.0',
+        date: '2026-02-12',
+        changes: [
+            'Initial release',
+            '1,738 mobile best practices across 15 CSV files',
+            'Support for 15 AI coding assistants',
+            'BM25 search engine with auto-domain detection',
+            '--stack and --persist flags',
+            '79 copy-paste code snippets (Android, iOS, Flutter, React Native)',
+            '78 Gradle dependency declarations',
+            '49 architecture patterns',
+            '415 platform-specific guidelines (Android 246, iOS 60, Flutter 54, React Native 55)',
+            'Reference URLs for all entries',
+        ],
+    },
+];
+export function versionsCommand() {
+    console.log(chalk.bold('\nMobile Best Practices - Version History\n'));
+    for (const v of VERSIONS) {
+        console.log(`  ${chalk.green(v.version)} ${chalk.dim(`(${v.date})`)}`);
+        for (const change of v.changes) {
+            console.log(`    ${chalk.dim('-')} ${change}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=versions.js.map

package/dist/commands/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/commands/versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,QAAQ,GAAc;IAC1B;QACE,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE;YACP,iBAAiB;YACjB,iDAAiD;YACjD,qCAAqC;YACrC,+CAA+C;YAC/C,6BAA6B;YAC7B,mEAAmE;YACnE,mCAAmC;YACnC,0BAA0B;YAC1B,qFAAqF;YACrF,gCAAgC;SACjC;KACF;CACF,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC,CAAC;IAEvE,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,KAAK,MAAM,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { updateCommand } from './commands/update.js';
+import { versionsCommand } from './commands/versions.js';
+const program = new Command();
+program
+    .name('mobile-best-practices')
+    .description('CLI to install Mobile Best Practices skill for AI coding assistants')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Install mobile best practices skill for your AI assistant')
+    .option('--ai <platform>', 'AI assistant (claude, cursor, windsurf, copilot, kiro, codex, gemini, roocode, continue, opencode, qoder, codebuddy, trae, antigravity, all)')
+    .option('--platform <mobile>', 'Mobile platform (android, ios, flutter, react-native, all)')
+    .option('--offline', 'Skip GitHub, use bundled assets')
+    .action(initCommand);
+program
+    .command('update')
+    .description('Check for and install updates')
+    .action(updateCommand);
+program
+    .command('versions')
+    .description('List available versions and changelog')
+    .action(versionsCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,uBAAuB,CAAC;KAC7B,WAAW,CAAC,qEAAqE,CAAC;KAClF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,iBAAiB,EAAE,8IAA8I,CAAC;KACzK,MAAM,CAAC,qBAAqB,EAAE,4DAA4D,CAAC;KAC3F,MAAM,CAAC,WAAW,EAAE,iCAAiC,CAAC;KACtD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,uCAAuC,CAAC;KACpD,MAAM,CAAC,eAAe,CAAC,CAAC;AAE3B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,23 @@
+export interface PlatformConfig {
+    name: string;
+    displayName: string;
+    type: 'skill' | 'rules' | 'instructions' | 'workflow' | 'skills';
+    installPath: string;
+    files: Record<string, string>;
+    settings?: {
+        file: string;
+        permissions: string[];
+    };
+    ruleFormat?: string;
+    skillPath: string;
+}
+export type AIPlatform = 'claude' | 'cursor' | 'windsurf' | 'copilot' | 'kiro' | 'codex' | 'gemini' | 'roocode' | 'continue' | 'opencode' | 'qoder' | 'codebuddy' | 'trae' | 'agent' | 'antigravity' | 'all';
+export declare const SUPPORTED_PLATFORMS: AIPlatform[];
+export type MobilePlatform = 'android' | 'ios' | 'flutter' | 'react-native' | 'all';
+export declare const MOBILE_PLATFORMS: MobilePlatform[];
+export interface Version {
+    version: string;
+    date: string;
+    changes: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,OAAO,GACP,aAAa,GACb,KAAK,CAAC;AAEV,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAgB3C,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,KAAK,CAAC;AAEpF,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAK5C,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types/index.js

@@ -0,0 +1,24 @@
+export const SUPPORTED_PLATFORMS = [
+    'claude',
+    'cursor',
+    'windsurf',
+    'copilot',
+    'kiro',
+    'codex',
+    'gemini',
+    'roocode',
+    'continue',
+    'opencode',
+    'qoder',
+    'codebuddy',
+    'trae',
+    'agent',
+    'antigravity',
+];
+export const MOBILE_PLATFORMS = [
+    'android',
+    'ios',
+    'flutter',
+    'react-native',
+];
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,WAAW;IACX,MAAM;IACN,OAAO;IACP,aAAa;CACd,CAAC;AAIF,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,SAAS;IACT,KAAK;IACL,SAAS;IACT,cAAc;CACf,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+import type { PlatformConfig, MobilePlatform } from '../types/index.js';
+export declare function getAssetsDir(): string;
+export declare function getTemplatesDir(): string;
+export declare function loadPlatformConfig(platform: string): PlatformConfig;
+export declare function ensureDir(dir: string): void;
+export declare function copyDir(src: string, dest: string): void;
+export declare function generateSkillFile(config: PlatformConfig, targetDir: string, mobilePlatform?: MobilePlatform): void;
+export declare function installForPlatform(platform: string, projectDir: string, mobilePlatform?: MobilePlatform): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxE,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAMnE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,cAAsB,GACrC,IAAI,CA2CN;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,cAAsB,GACrC,IAAI,CA+CN"}

package/dist/utils/index.js

@@ -0,0 +1,103 @@
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function getAssetsDir() {
+    return join(__dirname, '..', '..', 'assets');
+}
+export function getTemplatesDir() {
+    return join(getAssetsDir(), 'templates');
+}
+export function loadPlatformConfig(platform) {
+    const configPath = join(getTemplatesDir(), 'platforms', `${platform}.json`);
+    if (!existsSync(configPath)) {
+        throw new Error(`Platform config not found: ${platform}`);
+    }
+    return JSON.parse(readFileSync(configPath, 'utf-8'));
+}
+export function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+export function copyDir(src, dest) {
+    ensureDir(dest);
+    cpSync(src, dest, { recursive: true });
+}
+export function generateSkillFile(config, targetDir, mobilePlatform = 'all') {
+    const assetsDir = getAssetsDir();
+    const skillsDir = join(assetsDir, 'skills');
+    const skillPath = config.skillPath;
+    // Try to load platform-specific skill file
+    const skillFileName = mobilePlatform === 'all' ? 'all.md' : `${mobilePlatform}.md`;
+    const platformSkillPath = join(skillsDir, skillFileName);
+    let content;
+    if (existsSync(platformSkillPath)) {
+        // Use platform-specific SKILL.md
+        content = readFileSync(platformSkillPath, 'utf-8');
+        content = content.replace(/\{SKILL_PATH\}/g, skillPath);
+    }
+    else {
+        // Fallback to template-based generation
+        const baseContent = readFileSync(join(getTemplatesDir(), 'base', 'skill-content.md'), 'utf-8');
+        const quickRef = readFileSync(join(getTemplatesDir(), 'base', 'quick-reference.md'), 'utf-8');
+        let processedBase = baseContent.replace(/\{SKILL_PATH\}/g, skillPath);
+        let processedQuickRef = quickRef.replace(/\{SKILL_PATH\}/g, skillPath);
+        content = `---
+name: mobile-best-practices
+description: "Mobile development intelligence for Android, iOS, Flutter, and React Native. 1,738 best practices."
+---
+
+${processedBase}
+
+${processedQuickRef}
+`;
+    }
+    const targetFile = join(targetDir, config.files.skill || config.files.rule || config.files.instructions || config.files.workflow || 'SKILL.md');
+    ensureDir(dirname(targetFile));
+    writeFileSync(targetFile, content, 'utf-8');
+}
+export function installForPlatform(platform, projectDir, mobilePlatform = 'all') {
+    const config = loadPlatformConfig(platform);
+    const targetDir = join(projectDir, config.installPath);
+    ensureDir(targetDir);
+    // Copy data and scripts
+    const assetsDir = getAssetsDir();
+    if (config.type === 'skill' || config.type === 'skills') {
+        copyDir(join(assetsDir, 'data'), join(targetDir, 'data'));
+        copyDir(join(assetsDir, 'scripts'), join(targetDir, 'scripts'));
+        copyDir(join(assetsDir, 'references'), join(targetDir, 'references'));
+        generateSkillFile(config, targetDir, mobilePlatform);
+    }
+    else {
+        // For rules/instructions/workflow, generate a single file
+        generateSkillFile(config, targetDir, mobilePlatform);
+        // Also copy data and scripts to a shared location
+        const sharedDir = join(projectDir, '.mobile-best-practices');
+        copyDir(join(assetsDir, 'data'), join(sharedDir, 'data'));
+        copyDir(join(assetsDir, 'scripts'), join(sharedDir, 'scripts'));
+    }
+    // Create settings file if needed (Claude only)
+    if (config.settings) {
+        const settingsPath = join(projectDir, config.settings.file);
+        ensureDir(dirname(settingsPath));
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        }
+        if (!settings.permissions) {
+            settings.permissions = { allow: [] };
+        }
+        if (!settings.permissions.allow) {
+            settings.permissions.allow = [];
+        }
+        for (const perm of config.settings.permissions) {
+            if (!settings.permissions.allow.includes(perm)) {
+                settings.permissions.allow.push(perm);
+            }
+        }
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mobile-best-practices",
+  "version": "1.0.0",
+  "description": "CLI to install Mobile Best Practices skill for AI coding assistants",
+  "type": "module",
+  "bin": {
+    "mobile-best-practices": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "npx tsx src/index.ts",
+    "_prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "mobile",
+    "android",
+    "ios",
+    "flutter",
+    "react-native",
+    "best-practices",
+    "claude",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "ai-skill",
+    "jetpack-compose",
+    "swiftui",
+    "architecture",
+    "mvvm",
+    "clean-architecture"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tungnk123/mobile-best-practices.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/tungnk123/mobile-best-practices#readme",
+  "bugs": {
+    "url": "https://github.com/tungnk123/mobile-best-practices/issues"
+  }
+}