@bug_hunter/expo-kit 1.0.0

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../src/index.js')

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@bug_hunter/expo-kit",
+  "version": "1.0.0",
+  "description": "CLI to scaffold a React Native + Expo project from your base template",
+  "bin": {
+    "expo-kit": "./bin/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "author": "bug_hunter",
+  "keywords": [
+    "react-native",
+    "expo",
+    "cli",
+    "boilerplate",
+    "starter",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zartabkhalil/expo-kit.git"
+  },
+  "type": "commonjs",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "enquirer": "^2.4.1",
+    "execa": "^5.1.1",
+    "fs-extra": "^11.3.5",
+    "ora": "^5.4.1"
+  }
+}

package/src/index.js

@@ -0,0 +1,39 @@
+const path = require("path");
+const { askQuestions } = require("./prompts");
+const { cloneTemplate } = require("./steps/clone");
+const { configureApp } = require("./steps/configure");
+const { resetGit } = require("./steps/git");
+const { configureModules } = require("./steps/modules");
+const { installDependencies } = require("./steps/install");
+const logger = require("./utils/logger");
+
+async function run() {
+  // ─── Welcome ───────────────────────────────────────────────
+  logger.welcome();
+
+  // ─── Step 1: Ask questions ─────────────────────────────────
+  const answers = await askQuestions();
+
+  // ─── Compute target path ───────────────────────────────────
+  const targetPath = path.join(process.cwd(), answers.projectName);
+
+  // ─── Step 2: Clone template ────────────────────────────────
+  await cloneTemplate(answers, targetPath);
+
+  // ─── Step 3: Configure app.json ───────────────────────────
+  await configureApp(answers, targetPath);
+
+  // ─── Step 4: Reset git history ─────────────────────────────
+  await resetGit(answers, targetPath);
+
+  // ─── Step 5: Configure modules ─────────────────────────────
+  await configureModules(answers, targetPath);
+
+  // ─── Step 6: Install dependencies ─────────────────────────
+  await installDependencies(answers, targetPath);
+
+  // ─── Done ──────────────────────────────────────────────────
+  logger.success(answers);
+}
+
+run();

package/src/prompts.js

@@ -0,0 +1,44 @@
+const { prompt } = require("enquirer");
+
+async function askQuestions() {
+  const answers = await prompt([
+    {
+      type: "input",
+      name: "projectName",
+      message: "Project name?",
+      initial: "my-app",
+      validate(value) {
+        if (!value) return "Project name is required";
+        if (!/^[a-z0-9-]+$/.test(value))
+          return "Only lowercase letters, numbers and hyphens";
+        return true;
+      },
+    },
+    {
+      type: "input",
+      name: "bundleId",
+      message: "Bundle ID?",
+      initial: "com.yourname.myapp",
+      validate(value) {
+        if (!value) return "Bundle ID is required";
+        if (!/^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/.test(value))
+          return "Must be like com.yourname.appname";
+        return true;
+      },
+    },
+    {
+      type: "multiselect",
+      name: "selectedModules",
+      message: "Which modules do you need?",
+      choices: [
+        { name: "auth", message: "Auth — email + password login" },
+        { name: "redux", message: "Redux — state management" },
+      ],
+      hint: "(Space to select, Enter to confirm)",
+    },
+  ]);
+
+  return answers;
+}
+
+module.exports = { askQuestions };

package/src/steps/clone.js

@@ -0,0 +1,36 @@
+const ora = require("ora");
+const chalk = require("chalk");
+const execa = require("execa");
+const fs = require("fs-extra");
+const path = require("path");
+const logger = require("../utils/logger");
+
+const TEMPLATE_REPO = "https://github.com/zartabkhalil/rn-template.git";
+
+async function cloneTemplate(answers) {
+  const { projectName } = answers;
+  const targetPath = path.join(process.cwd(), projectName);
+
+  // Check folder doesn't already exist
+  if (await fs.pathExists(targetPath)) {
+    logger.error(
+      `Folder "${projectName}" already exists. Choose a different name.`,
+    );
+    process.exit(1);
+  }
+
+  const spinner = ora(`Cloning template into ${projectName}...`).start();
+
+  try {
+    await execa("git", ["clone", TEMPLATE_REPO, projectName]);
+    spinner.succeed(chalk.green("Template cloned"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to clone template"));
+    logger.error(error.message);
+    process.exit(1);
+  }
+
+  return targetPath;
+}
+
+module.exports = { cloneTemplate, TEMPLATE_REPO };

package/src/steps/configure.js

@@ -0,0 +1,34 @@
+const ora = require("ora");
+const chalk = require("chalk");
+const fs = require("fs-extra");
+const path = require("path");
+const logger = require("../utils/logger");
+
+async function configureApp(answers, targetPath) {
+  const { projectName, bundleId } = answers;
+
+  const spinner = ora("Updating app name and bundle ID...").start();
+
+  try {
+    const appJsonPath = path.join(targetPath, "app.json");
+    const appJson = await fs.readJson(appJsonPath);
+
+    // Update app name
+    appJson.expo.name = projectName;
+    appJson.expo.slug = projectName;
+    appJson.expo.scheme = projectName;
+
+    // Update bundle ID
+    appJson.expo.ios.bundleIdentifier = bundleId;
+    appJson.expo.android.package = bundleId;
+
+    await fs.writeJson(appJsonPath, appJson, { spaces: 2 });
+    spinner.succeed(chalk.green("app.json updated"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to update app.json"));
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { configureApp };

package/src/steps/git.js

@@ -0,0 +1,34 @@
+const ora = require("ora");
+const chalk = require("chalk");
+const execa = require("execa");
+const fs = require("fs-extra");
+const path = require("path");
+const logger = require("../utils/logger");
+
+async function resetGit(answers, targetPath) {
+  const { projectName } = answers;
+
+  const spinner = ora("Resetting git history...").start();
+
+  try {
+    // Remove existing git history from template
+    await fs.remove(path.join(targetPath, ".git"));
+
+    // Init a fresh repo
+    await execa("git", ["init"], { cwd: targetPath });
+    await execa("git", ["add", "."], { cwd: targetPath });
+    await execa(
+      "git",
+      ["commit", "-m", `init: ${projectName} created with create-rn-app`],
+      { cwd: targetPath },
+    );
+
+    spinner.succeed(chalk.green("Git history reset"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to reset git history"));
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { resetGit };

package/src/steps/install.js

@@ -0,0 +1,19 @@
+const ora = require("ora");
+const chalk = require("chalk");
+const execa = require("execa");
+const logger = require("../utils/logger");
+
+async function installDependencies(answers, targetPath) {
+  const spinner = ora("Installing dependencies...").start();
+
+  try {
+    await execa("npm", ["install", "--legacy-peer-deps"], { cwd: targetPath });
+    spinner.succeed(chalk.green("Dependencies installed"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to install dependencies"));
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { installDependencies };

package/src/steps/modules.js

@@ -0,0 +1,76 @@
+const ora = require("ora");
+const chalk = require("chalk");
+const fs = require("fs-extra");
+const path = require("path");
+const logger = require("../utils/logger");
+
+// ─── Module definitions ────────────────────────────────────────
+// Add new modules here as the toolkit grows
+const MODULE_REGISTRY = {
+  auth: {
+    folder: "auth",
+    deps: [
+      "expo-secure-store",
+      "react-hook-form",
+      "@hookform/resolvers",
+      "zod",
+    ],
+  },
+  redux: {
+    folder: "redux",
+    deps: ["@reduxjs/toolkit", "react-redux"],
+  },
+};
+
+async function configureModules(answers, targetPath) {
+  const { selectedModules } = answers;
+  const modulesPath = path.join(targetPath, "src", "modules");
+  const packageJsonPath = path.join(targetPath, "package.json");
+
+  const spinner = ora("Configuring modules...").start();
+
+  try {
+    const depsToRemove = [];
+
+    for (const [moduleName, moduleConfig] of Object.entries(MODULE_REGISTRY)) {
+      const modulePath = path.join(modulesPath, moduleConfig.folder);
+      const isSelected = selectedModules.includes(moduleName);
+      const exists = await fs.pathExists(modulePath);
+
+      if (!isSelected && exists) {
+        // Remove module folder
+        await fs.remove(modulePath);
+        logger.step(`removed module: ${moduleName}`);
+
+        // Queue dependencies for removal
+        depsToRemove.push(...moduleConfig.deps);
+      }
+
+      if (isSelected) {
+        logger.step(`included module: ${moduleName}`);
+      }
+    }
+
+    // Remove unused dependencies from package.json
+    if (depsToRemove.length > 0) {
+      const packageJson = await fs.readJson(packageJsonPath);
+
+      depsToRemove.forEach((dep) => {
+        if (packageJson.dependencies[dep]) {
+          delete packageJson.dependencies[dep];
+          logger.step(`removed dep: ${dep}`);
+        }
+      });
+
+      await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    }
+
+    spinner.succeed(chalk.green("Modules configured"));
+  } catch (error) {
+    spinner.fail(chalk.red("Failed to configure modules"));
+    logger.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = { configureModules, MODULE_REGISTRY };

package/src/utils/logger.js

@@ -0,0 +1,38 @@
+const chalk = require("chalk");
+
+const logger = {
+  welcome() {
+    console.log(chalk.bold.blue("Welcome to create-rn-app 🚀"));
+    console.log(chalk.gray("Setting up your React Native project...\n"));
+  },
+
+  step(message) {
+    console.log(chalk.gray(`  ${message}`));
+  },
+
+  success(answers) {
+    console.log("\n" + chalk.bold.green("✔ Project ready!"));
+    console.log(chalk.gray("─────────────────────────────────────"));
+    console.log(chalk.white("  Modules installed:"));
+    if (answers.selectedModules.length === 0) {
+      console.log(chalk.gray("  none — base template only"));
+    } else {
+      answers.selectedModules.forEach((m) =>
+        console.log(chalk.cyan(`  ✔ ${m}`)),
+      );
+    }
+    console.log(chalk.gray("─────────────────────────────────────"));
+    console.log(chalk.white("  Next steps:"));
+    console.log(chalk.cyan(`  cd ${answers.projectName}`));
+    console.log(chalk.cyan("  npx expo start --ios"));
+    console.log(chalk.gray("─────────────────────────────────────\n"));
+    console.log(chalk.gray("  note: installed with --legacy-peer-deps"));
+    console.log(chalk.gray("  run: npx expo install --fix if needed\n"));
+  },
+
+  error(message) {
+    console.log(chalk.red(`✖ ${message}`));
+  },
+};
+
+module.exports = logger;