@getpara/create-para-app 0.1.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@getpara/create-para-app",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "create-para-app": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "start": "node --no-warnings dist/index.js",
+    "dev": "node --no-warnings --loader ts-node/esm src/index.ts"
+  },
+  "dependencies": {
+    "chalk": "5.4.1",
+    "commander": "13.1.0",
+    "execa": "9.5.2",
+    "fs-extra": "11.3.0",
+    "inquirer": "12.4.1",
+    "ora": "8.2.0",
+    "prettier": "3.5.0",
+    "update-notifier": "7.3.1"
+  },
+  "devDependencies": {
+    "@types/chalk": "^2.2.4",
+    "@types/commander": "^2.12.5",
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.13.1",
+    "@types/update-notifier": "6.0.8",
+    "@types/fs-extra": "11.0.4",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3"
+  }
+}

package/src/commands/scaffold.ts

@@ -0,0 +1,196 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import { promptInteractive } from '../prompts/interactive.js';
+import { scaffoldNextjs } from '../templates/nextjs.js';
+import { scaffoldViteReact } from '../templates/vite-react.js';
+import { runSDKSetup } from '../integrations/sdkSetup.js';
+import { logInfo, logError, logHeader, logSection, logSubsection } from '../utils/logger.js';
+
+interface ScaffoldOptions {
+  projectName?: string;
+  template?: string;
+  useLatest?: boolean;
+  noPrompt?: boolean;
+  noGit?: boolean;
+  packageManager?: string;
+  skipDeps?: boolean;
+  typescript?: boolean;
+  eslint?: boolean;
+  tailwind?: boolean;
+  srcDir?: boolean;
+  app?: boolean;
+
+  networks?: string;
+  evmSigner?: string;
+  externalWallet?: boolean;
+  apiKey?: string;
+}
+
+interface ScaffoldConfig {
+  projectName: string;
+  template: string;
+  networks: string[];
+  evmSigner?: string;
+  apiKey: string;
+  externalWalletSupport: boolean;
+  useLatest: boolean;
+  noGit: boolean;
+  packageManager: string;
+  skipDeps: boolean;
+  typescript: boolean;
+  eslint: boolean;
+  tailwind: boolean;
+  srcDir: boolean;
+  app: boolean;
+}
+
+function validateOptions(options?: ScaffoldOptions) {
+  if (options?.template && !['nextjs', 'vite-react'].includes(options.template)) {
+    throw new Error(`Invalid template '${options.template}'. Valid templates: nextjs, vite-react.`);
+  }
+
+  if (options?.evmSigner && !['ethers', 'viem'].includes(options.evmSigner)) {
+    throw new Error(`Invalid EVM signer '${options.evmSigner}'. Valid signers: ethers, viem.`);
+  }
+
+  if (options?.networks) {
+    const nets = options.networks.split(',').map(n => n.trim());
+    for (const network of nets) {
+      if (!['evm', 'cosmos', 'solana'].includes(network)) {
+        throw new Error(`Invalid network '${network}'. Valid options: evm, cosmos, solana.`);
+      }
+    }
+  }
+}
+
+function cleanupProjectDirectory(projectName: string) {
+  if (!projectName) return;
+  try {
+    if (fs.existsSync(projectName)) {
+      fs.removeSync(projectName);
+    }
+  } catch {}
+}
+
+export default async function scaffold(positionalProjectName?: string, options?: ScaffoldOptions) {
+  try {
+    validateOptions(options);
+
+    const {
+      projectName: cliProjectName,
+      template: cliTemplate,
+      useLatest,
+      noPrompt,
+      noGit,
+      packageManager,
+      skipDeps,
+      typescript = true,
+      eslint = true,
+      tailwind = true,
+      srcDir = true,
+      app = true,
+      networks,
+      evmSigner,
+      externalWallet,
+      apiKey,
+    } = options || {};
+
+    // For rollback reference
+    const finalProjectName = cliProjectName || positionalProjectName;
+
+    let config: ScaffoldConfig = {
+      projectName: finalProjectName || '',
+      template: cliTemplate || '',
+      networks: [],
+      evmSigner: '',
+      apiKey: apiKey || '',
+      externalWalletSupport: externalWallet,
+      useLatest: !!useLatest,
+      noGit: !!noGit,
+      packageManager: packageManager || 'yarn',
+      skipDeps: !!skipDeps,
+      typescript,
+      eslint,
+      tailwind,
+      srcDir,
+      app,
+    };
+
+    // Populate networks if provided
+    if (networks) {
+      config.networks = networks.split(',').map(n => n.trim());
+    }
+    if (evmSigner) {
+      config.evmSigner = evmSigner;
+    }
+
+    // We'll decide if we must prompt
+    const needTemplate = !config.template;
+    const needProjectName = !config.projectName;
+    const needNetworks = !config.networks.length;
+    const needEvmSigner = config.networks.includes('evm') && !config.evmSigner;
+    const needApiKey = !config.apiKey;
+
+    const shouldPrompt = !noPrompt && (needTemplate || needProjectName || needNetworks || needEvmSigner || needApiKey);
+
+    if (shouldPrompt) {
+      const answers = await promptInteractive(config);
+
+      config.projectName = answers.projectName || `para-${answers.template}-template`;
+      config.template = answers.template;
+      config.networks = answers.networks;
+      config.evmSigner = answers.evmSigner || (answers.networks.includes('evm') ? 'ethers' : '');
+      config.apiKey = answers.apiKey;
+      config.externalWalletSupport = answers.externalWalletSupport;
+    } else {
+      if (!config.projectName) {
+        const t = cliTemplate || 'nextjs';
+        config.projectName = `para-${t}-template`;
+      }
+      if (!config.template) {
+        config.template = 'nextjs';
+      }
+      if (!config.networks.length) {
+        config.networks = [];
+      }
+      if (!config.evmSigner && config.networks.includes('evm')) {
+        config.evmSigner = 'ethers';
+      }
+    }
+
+    if (fs.existsSync(config.projectName)) {
+      throw new Error(`Project folder '${config.projectName}' already exists. Please remove or choose a different name.`);
+    }
+
+    logHeader(`🚀 Creating a new project named: ${config.projectName}`);
+    logSection('🔧 Project Configuration:');
+    logSubsection('Project Type', config.template);
+    logSubsection('Supported Networks', config.networks.length > 0 ? config.networks.join(', ') : 'None');
+    if (config.networks.includes('evm')) {
+      logSubsection('EVM Signer', config.evmSigner);
+    }
+    logSubsection('API Key', config.apiKey);
+    logSubsection('External Wallet Support', config.externalWalletSupport ? 'Enabled' : 'Disabled');
+    logSubsection('TypeScript', config.typescript ? 'Enabled' : 'Disabled');
+    logSubsection('ESLint', config.eslint ? 'Enabled' : 'Disabled');
+    logSubsection('Tailwind', config.tailwind ? 'Enabled' : 'Disabled');
+    logSubsection('src/ directory', config.srcDir ? 'Enabled' : 'Disabled');
+    logSubsection('App Router', config.app ? 'Enabled' : 'Disabled');
+
+    if (config.template === 'vite-react') {
+      await scaffoldViteReact(config);
+    } else {
+      await scaffoldNextjs(config);
+    }
+
+    await runSDKSetup(config);
+
+    logInfo(chalk.green('✅ Scaffolding complete!'));
+  } catch (error: any) {
+    logError(`Error: ${error.message || error}`);
+
+    cleanupProjectDirectory(options?.projectName || positionalProjectName || '');
+
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -0,0 +1,43 @@
+import { program } from 'commander';
+import updateNotifier from 'update-notifier';
+import pkg from '../package.json' assert { type: 'json' };
+import scaffold from './commands/scaffold.js';
+
+updateNotifier({ pkg }).notify();
+
+program
+  .name('create-para-app')
+  .description('CLI tool for scaffolding new apps with Para SDKs')
+  .version(pkg.version)
+  .usage('[projectName] [options]')
+  .helpOption('--help', 'Display help for command');
+
+program
+  .argument('[projectName]')
+  .description('Scaffold a new app with specified template and features')
+  .option('--template <template>', 'Specify the template: nextjs or vite-react')
+  .option('--use-latest', 'Use the latest version of the underlying framework')
+  .option('--no-prompt', 'Skip interactive prompts')
+  .option('--no-git', 'Disable git initialization')
+  .option('--package-manager <pm>', 'Specify package manager: npm, yarn, bun, pnpm', 'yarn')
+  .option('--skip-deps', 'Skip dependency installation')
+  .option('--typescript', 'Enable TypeScript (default: enabled)', true)
+  .option('--no-typescript', 'Disable TypeScript')
+  .option('--eslint', 'Enable ESLint (default: enabled)', true)
+  .option('--no-eslint', 'Disable ESLint')
+  .option('--tailwind', 'Enable Tailwind CSS (default: enabled)', true)
+  .option('--no-tailwind', 'Disable Tailwind CSS')
+  .option('--src-dir', 'Use src/ directory (default: enabled)', true)
+  .option('--no-src-dir', 'Disable src/ directory')
+  .option('--app', 'Use the App Router (default: enabled)', true)
+  .option('--no-app', 'Disable App Router')
+  .option('--networks <list>', 'Comma separated networks: "evm,cosmos,solana"')
+  .option('--evm-signer <signer>', 'Specify EVM signer: "ethers" or "viem"')
+  .option('--external-wallet', 'Enable external wallet support (default: false)')
+  .option('--api-key <key>', 'Provide your API key to skip prompt')
+  .option('--project-name <name>', 'Explicitly set project name to skip name prompt')
+  .action(async (projectName, options) => {
+    await scaffold(projectName, options);
+  });
+
+program.parse(process.argv);