create-react-native-starter-kit 0.0.0-stage → 1.0.1

package/lib/patch-native.js

@@ -0,0 +1,588 @@
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Find files recursively matching a pattern or name
+ */
+function findFile(dir, fileName) {
+  if (!fs.existsSync(dir)) return null;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === 'node_modules' || entry.name === 'Pods' || entry.name === 'build') continue;
+      const found = findFile(fullPath, fileName);
+      if (found) return found;
+    } else if (entry.name === fileName) {
+      return fullPath;
+    }
+  }
+  return null;
+}
+
+/**
+ * Patch android/app/build.gradle
+ */
+function patchAndroidBuildGradle(projectDir) {
+  const gradlePath = path.join(projectDir, 'android', 'app', 'build.gradle');
+  if (!fs.existsSync(gradlePath)) {
+    console.log('⚠️ Could not find android/app/build.gradle');
+    return false;
+  }
+
+  let content = fs.readFileSync(gradlePath, 'utf8');
+
+  // Check if androidx.activity is already added
+  if (!content.includes('androidx.activity:activity')) {
+    const target = 'dependencies {';
+    const injection = `dependencies {
+    implementation("androidx.activity:activity:1.+") //by own`;
+    if (content.includes(target)) {
+      content = content.replace(target, injection);
+      fs.writeFileSync(gradlePath, content, 'utf8');
+      console.log('✅ Patched android/app/build.gradle');
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * Patch MainActivity.kt
+ */
+function patchAndroidMainActivity(projectDir) {
+  const javaDir = path.join(projectDir, 'android', 'app', 'src', 'main', 'java');
+  const mainActivityPath = findFile(javaDir, 'MainActivity.kt');
+
+  if (!mainActivityPath) {
+    console.log('⚠️ Could not find MainActivity.kt');
+    return false;
+  }
+
+  let content = fs.readFileSync(mainActivityPath, 'utf8');
+
+  const requiredImports = [
+    'android.os.Bundle',
+    'com.facebook.react.ReactApplication',
+    'com.swmansion.rnscreens.fragment.restoration.RNScreensFragmentFactory',
+  ].filter(name => !new RegExp(`^import\\s+${name.replace(/\./g, '\\.')}\\s*$`, 'm').test(content));
+
+  if (requiredImports.length > 0) {
+    const importBlock = `//By Own\n${requiredImports.map(name => `import ${name}`).join('\n')}\n`;
+    // Match only the package line itself so the inserted block always ends on its own line.
+    const packageLineRegex = /^package\s+[\w.]+[ \t]*\r?\n/m;
+    if (packageLineRegex.test(content)) {
+      content = content.replace(packageLineRegex, match => `${match}\n${importBlock}`);
+    } else {
+      content = `${importBlock}\n${content}`;
+    }
+  }
+
+  const activityHooks = `
+  //By Own
+  override fun onCreate(savedInstanceState: Bundle?) {
+    supportFragmentManager.fragmentFactory = RNScreensFragmentFactory()
+    super.onCreate(savedInstanceState)
+    reloadIfDisplaySizeChanged()
+  }
+
+  /**
+   * Changing "Display size" recreates this activity but keeps the JS runtime alive, so sizes
+   * computed once at JS load (normalize(), screen-width constants) stay stale and layouts break.
+   * Reloading the bundle recomputes them for the new density.
+   */
+  private fun reloadIfDisplaySizeChanged() {
+    val densityDpi = resources.configuration.densityDpi
+    if (lastDensityDpi != 0 && lastDensityDpi != densityDpi) {
+      (application as ReactApplication).reactHost?.reload("Display size changed")
+    }
+    lastDensityDpi = densityDpi
+  }
+
+  //By Own
+  private companion object {
+    /** Survives activity recreation (same process); 0 means first launch. */
+    var lastDensityDpi = 0
+  }
+`;
+
+  if (!content.includes('reloadIfDisplaySizeChanged')) {
+    const classRegex = /(class\s+MainActivity\s*:\s*ReactActivity\(\)\s*\{)/;
+    if (classRegex.test(content)) {
+      content = content.replace(classRegex, `$1${activityHooks}`);
+    }
+  }
+
+  fs.writeFileSync(mainActivityPath, content, 'utf8');
+  console.log('✅ Patched MainActivity.kt');
+  return true;
+}
+
+/**
+ * Patch AndroidManifest.xml
+ */
+function patchAndroidManifest(projectDir) {
+  const manifestPath = path.join(projectDir, 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
+  if (!fs.existsSync(manifestPath)) {
+    console.log('⚠️ Could not find AndroidManifest.xml');
+    return false;
+  }
+
+  let content = fs.readFileSync(manifestPath, 'utf8');
+  let modified = false;
+
+  if (!content.includes('xmlns:tools')) {
+    content = content.replace(
+      '<manifest xmlns:android="http://schemas.android.com/apk/res/android"',
+      '<manifest xmlns:android="http://schemas.android.com/apk/res/android"\n    xmlns:tools="http://schemas.android.com/tools"',
+    );
+    modified = true;
+  }
+
+  if (!content.includes('android.permission.CAMERA')) {
+    const permissionBlock = `    <uses-permission android:name="android.permission.CAMERA" />
+    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
+    <uses-permission
+      android:name="android.permission.READ_EXTERNAL_STORAGE"
+      android:maxSdkVersion="32" />
+    <!-- RN debug adds this for Metro over LAN; use adb reverse instead. -->
+    <uses-permission
+      android:name="android.permission.ACCESS_LOCAL_NETWORK"
+      tools:node="remove" />
+
+`;
+    if (content.includes('<application')) {
+      content = content.replace('<application', `${permissionBlock}<application`);
+      modified = true;
+    }
+  }
+
+  if (!content.includes('enableOnBackInvokedCallback')) {
+    content = content.replace(
+      '<application',
+      '<application\n      android:enableOnBackInvokedCallback="false"',
+    );
+    modified = true;
+  }
+
+  if (
+    content.includes('<activity') &&
+    !content.includes('android:screenOrientation=')
+  ) {
+    content = content.replace(
+      '<activity',
+      '<activity\n        android:screenOrientation="portrait"',
+    );
+    modified = true;
+  }
+
+  if (modified) {
+    fs.writeFileSync(manifestPath, content, 'utf8');
+    console.log('✅ Patched AndroidManifest.xml');
+  }
+  return modified;
+}
+
+/**
+ * Get all font files from src/assets/fonts
+ */
+function getFontFiles(projectDir) {
+  const fontsDir = path.join(projectDir, 'src', 'assets', 'fonts');
+  if (!fs.existsSync(fontsDir)) return [];
+  return fs.readdirSync(fontsDir).filter(f => f.endsWith('.ttf') || f.endsWith('.otf'));
+}
+
+/**
+ * Patch iOS Info.plist
+ */
+function patchIOSInfoPlist(projectDir) {
+  const iosDir = path.join(projectDir, 'ios');
+  const infoPlistPath = findFile(iosDir, 'Info.plist');
+
+  if (!infoPlistPath) {
+    console.log('⚠️ Could not find iOS Info.plist');
+    return false;
+  }
+
+  let content = fs.readFileSync(infoPlistPath, 'utf8');
+  let modified = false;
+
+  // Add Photo & Camera Permissions
+  const permissionsToAdd = [];
+  if (!content.includes('NSPhotoLibraryUsageDescription')) {
+    permissionsToAdd.push(`\t<key>NSPhotoLibraryUsageDescription</key>
+\t<string>We need access to your photo gallery to update your profile picture.</string>`);
+  }
+  if (!content.includes('NSCameraUsageDescription')) {
+    permissionsToAdd.push(`\t<key>NSCameraUsageDescription</key>
+\t<string>We need access to your camera to take photos for your profile picture.</string>`);
+  }
+
+  // Add UIAppFonts
+  const fonts = getFontFiles(projectDir);
+  if (fonts.length > 0 && !content.includes('<key>UIAppFonts</key>')) {
+    const fontStrings = fonts.map(font => `\t\t<string>${font}</string>`).join('\n');
+    permissionsToAdd.push(`\t<key>UIAppFonts</key>
+\t<array>
+${fontStrings}
+\t</array>`);
+  }
+
+  if (content.includes('UIInterfaceOrientationLandscapeLeft')) {
+    content = content.replace(
+      /<key>UISupportedInterfaceOrientations<\/key>\s*<array>[\s\S]*?<\/array>/,
+      `<key>UISupportedInterfaceOrientations</key>
+	<array>
+		<string>UIInterfaceOrientationPortrait</string>
+	</array>`,
+    );
+    modified = true;
+  }
+
+  if (permissionsToAdd.length > 0) {
+    const insertion = permissionsToAdd.join('\n') + '\n</dict>';
+    content = content.replace(/<\/dict>\s*<\/plist>/, `${insertion}\n</plist>`);
+    modified = true;
+  }
+
+  if (modified) {
+    fs.writeFileSync(infoPlistPath, content, 'utf8');
+    console.log('✅ Patched iOS Info.plist with permissions and custom fonts');
+  }
+
+  return modified;
+}
+
+const SCENE_MANIFEST = `\t<key>UIApplicationSceneManifest</key>
+\t<dict>
+\t\t<key>UIApplicationSupportsMultipleScenes</key>
+\t\t<false/>
+\t\t<key>UISceneConfigurations</key>
+\t\t<dict>
+\t\t\t<key>UIWindowSceneSessionRoleApplication</key>
+\t\t\t<array>
+\t\t\t\t<dict>
+\t\t\t\t\t<key>UISceneConfigurationName</key>
+\t\t\t\t\t<string>Default Configuration</string>
+\t\t\t\t\t<key>UISceneDelegateClassName</key>
+\t\t\t\t\t<string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
+\t\t\t\t</dict>
+\t\t\t</array>
+\t\t</dict>
+\t</dict>`;
+
+// Same shape as the current react-native-community/template, limited to APIs that exist in
+// React Native 0.87 (no connectionOptions overload and no scene-based RCTLinkingManager helpers).
+const APP_DELEGATE_SOURCE = `import UIKit
+
+@main
+class AppDelegate: UIResponder, UIApplicationDelegate {
+  func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
+  ) -> Bool {
+    true
+  }
+}
+`;
+
+const sceneDelegateSource = moduleName => `import React
+import React_RCTAppDelegate
+import ReactAppDependencyProvider
+import UIKit
+
+class SceneDelegate: RCTDefaultReactNativeFactoryDelegate, UIWindowSceneDelegate {
+  var window: UIWindow?
+  var reactNativeFactory: RCTReactNativeFactory?
+
+  func scene(
+    _ scene: UIScene,
+    willConnectTo session: UISceneSession,
+    options connectionOptions: UIScene.ConnectionOptions
+  ) {
+    guard let windowScene = scene as? UIWindowScene else {
+      return
+    }
+
+    dependencyProvider = RCTAppDependencyProvider()
+    reactNativeFactory = RCTReactNativeFactory(delegate: self)
+    window = UIWindow(windowScene: windowScene)
+
+    var launchOptions: [AnyHashable: Any] = [:]
+    if let url = connectionOptions.urlContexts.first?.url {
+      launchOptions[UIApplication.LaunchOptionsKey.url] = url
+    }
+
+    reactNativeFactory?.startReactNative(
+      withModuleName: "${moduleName}",
+      in: window,
+      launchOptions: launchOptions
+    )
+  }
+
+  func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
+    guard let url = URLContexts.first?.url else {
+      return
+    }
+    RCTLinkingManager.application(UIApplication.shared, open: url, options: [:])
+  }
+
+  func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
+    RCTLinkingManager.application(
+      UIApplication.shared,
+      continue: userActivity,
+      restorationHandler: { _ in }
+    )
+  }
+
+  override func sourceURL(for bridge: RCTBridge) -> URL? {
+    self.bundleURL()
+  }
+
+  override func bundleURL() -> URL? {
+#if DEBUG
+    RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
+#else
+    Bundle.main.url(forResource: "main", withExtension: "jsbundle")
+#endif
+  }
+}
+`;
+
+/** Xcode object IDs are 24 uppercase hex chars and only need to be unique within the pbxproj. */
+function newPbxprojId(pbxproj, taken = []) {
+  for (;;) {
+    const id = crypto.randomBytes(12).toString('hex').toUpperCase();
+    if (!pbxproj.includes(id) && !taken.includes(id)) return id;
+  }
+}
+
+function findXcodeProject(iosDir) {
+  if (!fs.existsSync(iosDir)) return null;
+  const projectDir = fs
+    .readdirSync(iosDir)
+    .find(entry => entry.endsWith('.xcodeproj') && entry !== 'Pods.xcodeproj');
+  if (!projectDir) return null;
+  const pbxprojPath = path.join(iosDir, projectDir, 'project.pbxproj');
+  return fs.existsSync(pbxprojPath) ? pbxprojPath : null;
+}
+
+/**
+ * Add SceneDelegate.swift next to every AppDelegate.swift entry (file reference, group, Sources
+ * phase). Returns null when the project does not have the layout the template generates.
+ */
+function addSceneDelegateToPbxproj(pbxproj, appFolder) {
+  if (pbxproj.includes('SceneDelegate.swift')) return pbxproj;
+
+  const buildFileLine = /^([ \t]*)(\w+) \/\* AppDelegate\.swift in Sources \*\/ = \{isa = PBXBuildFile; fileRef = (\w+) \/\* AppDelegate\.swift \*\/; \};$/m;
+  const buildFile = pbxproj.match(buildFileLine);
+  if (!buildFile) return null;
+  const [, indent, appBuildId, appRefId] = buildFile;
+
+  const fileRefLine = new RegExp(`^[ \\t]*${appRefId} /\\* AppDelegate\\.swift \\*/ = \\{isa = PBXFileReference;.*\\};$`, 'm');
+  const groupChild = new RegExp(`^([ \\t]*)${appRefId} /\\* AppDelegate\\.swift \\*/,$`, 'm');
+  const sourcesEntry = new RegExp(`^([ \\t]*)${appBuildId} /\\* AppDelegate\\.swift in Sources \\*/,$`, 'm');
+  if (!fileRefLine.test(pbxproj) || !groupChild.test(pbxproj) || !sourcesEntry.test(pbxproj)) {
+    return null;
+  }
+
+  const sceneFileRefId = newPbxprojId(pbxproj);
+  const sceneBuildFileId = newPbxprojId(pbxproj, [sceneFileRefId]);
+
+  return pbxproj
+    .replace(
+      buildFileLine,
+      match =>
+        `${match}\n${indent}${sceneBuildFileId} /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = ${sceneFileRefId} /* SceneDelegate.swift */; };`,
+    )
+    .replace(
+      fileRefLine,
+      match =>
+        `${match}\n${indent}${sceneFileRefId} /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; name = SceneDelegate.swift; path = ${appFolder}/SceneDelegate.swift; sourceTree = "<group>"; };`,
+    )
+    .replace(groupChild, (match, childIndent) => `${match}\n${childIndent}${sceneFileRefId} /* SceneDelegate.swift */,`)
+    .replace(
+      sourcesEntry,
+      (match, entryIndent) => `${match}\n${entryIndent}${sceneBuildFileId} /* SceneDelegate.swift in Sources */,`,
+    );
+}
+
+/**
+ * Bring an AppDelegate-only iOS project (React Native <= 0.87) to the scene-based layout of the
+ * current template: SceneDelegate.swift owns the window, AppDelegate is empty, Info.plist declares
+ * the scene. Newer projects that already ship SceneDelegate.swift are left as generated.
+ */
+function patchIOSSceneLifecycle(projectDir) {
+  const iosDir = path.join(projectDir, 'ios');
+  const appDelegatePath = findFile(iosDir, 'AppDelegate.swift');
+  if (!appDelegatePath) {
+    console.log('⚠️ Could not find AppDelegate.swift, skipped UIScene setup');
+    return false;
+  }
+
+  const appDir = path.dirname(appDelegatePath);
+  const sceneDelegatePath = path.join(appDir, 'SceneDelegate.swift');
+  if (fs.existsSync(sceneDelegatePath)) {
+    return false;
+  }
+
+  const appDelegate = fs.readFileSync(appDelegatePath, 'utf8');
+  const moduleName = appDelegate.match(/withModuleName:\s*"([^"]+)"/);
+  const infoPlistPath = path.join(appDir, 'Info.plist');
+  const pbxprojPath = findXcodeProject(iosDir);
+  const pbxproj = pbxprojPath && addSceneDelegateToPbxproj(fs.readFileSync(pbxprojPath, 'utf8'), path.basename(appDir));
+
+  if (!moduleName || !appDelegate.includes('RCTReactNativeFactory') || !fs.existsSync(infoPlistPath) || !pbxproj) {
+    console.log('⚠️ iOS project does not match the React Native template, skipped UIScene setup');
+    return false;
+  }
+
+  let infoPlist = fs.readFileSync(infoPlistPath, 'utf8');
+  if (!infoPlist.includes('UIApplicationSceneManifest')) {
+    infoPlist = infoPlist.replace(/<\/dict>\s*<\/plist>\s*$/, `${SCENE_MANIFEST}\n</dict>\n</plist>\n`);
+  }
+
+  fs.writeFileSync(sceneDelegatePath, sceneDelegateSource(moduleName[1]), 'utf8');
+  fs.writeFileSync(appDelegatePath, APP_DELEGATE_SOURCE, 'utf8');
+  fs.writeFileSync(infoPlistPath, infoPlist, 'utf8');
+  fs.writeFileSync(pbxprojPath, pbxproj, 'utf8');
+
+  console.log('✅ Moved iOS app startup to SceneDelegate.swift (UIScene life cycle)');
+  return true;
+}
+
+/**
+ * Keep CocoaPods on the same iOS minimum as the app target.
+ */
+function patchIOSPodfile(projectDir) {
+  const podfilePath = path.join(projectDir, 'ios', 'Podfile');
+  if (!fs.existsSync(podfilePath)) {
+    return false;
+  }
+
+  let content = fs.readFileSync(podfilePath, 'utf8');
+  if (content.includes("min_ios = '15.1'")) {
+    return false;
+  }
+
+  const marker = 'react_native_post_install(';
+  const start = content.indexOf(marker);
+  if (start === -1) {
+    return false;
+  }
+
+  const callEnd = content.indexOf('\n    )', start);
+  if (callEnd === -1) {
+    return false;
+  }
+
+  const injection = `
+    # Force every pod (including resource bundles) to match the app's
+    # iOS 15.1 minimum. Without this, some pods stay on 9.0 and Xcode fails.
+    min_ios = '15.1'
+    installer.pods_project.build_configurations.each do |config|
+      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = min_ios
+    end
+    installer.pods_project.targets.each do |target|
+      target.build_configurations.each do |config|
+        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = min_ios
+      end
+    end`;
+
+  content =
+    content.slice(0, callEnd + '\n    )'.length) +
+    injection +
+    content.slice(callEnd + '\n    )'.length);
+  fs.writeFileSync(podfilePath, content, 'utf8');
+  console.log('✅ Patched ios/Podfile deployment target');
+  return true;
+}
+
+/**
+ * The wrapper default (10s) drops the Gradle distribution download on slow networks.
+ */
+function patchGradleWrapper(projectDir) {
+  const wrapperPath = path.join(
+    projectDir,
+    'android',
+    'gradle',
+    'wrapper',
+    'gradle-wrapper.properties',
+  );
+  if (!fs.existsSync(wrapperPath)) {
+    return false;
+  }
+
+  const timeoutMs = 180000;
+  let content = fs.readFileSync(wrapperPath, 'utf8');
+  const match = content.match(/^networkTimeout=(\d+)\s*$/m);
+
+  if (match && Number(match[1]) >= timeoutMs) {
+    return false;
+  }
+
+  if (match) {
+    content = content.replace(
+      /^networkTimeout=\d+\s*$/m,
+      `networkTimeout=${timeoutMs}`,
+    );
+  } else if (content.includes('distributionUrl=')) {
+    content = content.replace(
+      /^(distributionUrl=.*)$/m,
+      `$1\nnetworkTimeout=${timeoutMs}`,
+    );
+  } else {
+    content = `${content.replace(/\s*$/, '')}\nnetworkTimeout=${timeoutMs}\n`;
+  }
+
+  fs.writeFileSync(wrapperPath, content, 'utf8');
+  console.log('✅ Patched gradle-wrapper.properties (networkTimeout)');
+  return true;
+}
+
+/**
+ * Draw behind system bars. Screens already use safe area insets.
+ */
+function patchGradleProperties(projectDir) {
+  const propsPath = path.join(projectDir, 'android', 'gradle.properties');
+  if (!fs.existsSync(propsPath)) {
+    return false;
+  }
+
+  let content = fs.readFileSync(propsPath, 'utf8');
+  if (!content.includes('edgeToEdgeEnabled=false')) {
+    return false;
+  }
+
+  content = content.replace('edgeToEdgeEnabled=false', 'edgeToEdgeEnabled=true');
+  fs.writeFileSync(propsPath, content, 'utf8');
+  console.log('✅ Patched android/gradle.properties (edgeToEdgeEnabled)');
+  return true;
+}
+
+/**
+ * Run all native patches
+ */
+function patchAllNative(projectDir) {
+  patchAndroidBuildGradle(projectDir);
+  patchAndroidMainActivity(projectDir);
+  patchAndroidManifest(projectDir);
+  patchGradleWrapper(projectDir);
+  patchGradleProperties(projectDir);
+  patchIOSInfoPlist(projectDir);
+  patchIOSSceneLifecycle(projectDir);
+  patchIOSPodfile(projectDir);
+}
+
+module.exports = {
+  patchAllNative,
+  patchAndroidBuildGradle,
+  patchAndroidMainActivity,
+  patchAndroidManifest,
+  patchGradleWrapper,
+  patchGradleProperties,
+  patchIOSInfoPlist,
+  patchIOSSceneLifecycle,
+  patchIOSPodfile,
+};

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "create-react-native-starter-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Create a React Native CLI app with a ready folder structure, shared components, theming, i18n, API layer, offline handling and native setup done for you",
+  "main": "bin/create-react-native-starter-kit.js",
+  "bin": {
+    "create-react-native-starter-kit": "bin/create-react-native-starter-kit.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "scripts",
+    "template",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "sync-template": "node scripts/sync-template.js",
+    "test": "node test-patchers.js",
+    "prepack": "node scripts/sync-template.js"
+  },
+  "keywords": [
+    "react-native",
+    "react-native-cli",
+    "starter",
+    "boilerplate",
+    "generator",
+    "scaffolder",
+    "template",
+    "starter-kit",
+    "typescript",
+    "react-navigation",
+    "redux-toolkit",
+    "tanstack-query"
+  ],
+  "author": "Satyam Narayan (https://github.com/satyam-narayan)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/satyam-narayan/create-react-native-starter-kit.git"
+  },
+  "homepage": "https://github.com/satyam-narayan/create-react-native-starter-kit#readme",
+  "bugs": {
+    "url": "https://github.com/satyam-narayan/create-react-native-starter-kit/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  }
+}

package/scripts/sync-template.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * Refreshes cli/template from the starter repo that contains this cli folder.
+ * Runs automatically before `npm pack` / `npm publish`.
+ * When the cli folder is used on its own (no parent repo), the existing template is kept.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { copyDirectoryRecursive } = require('../lib/copy-src');
+
+const CLI_ROOT = path.resolve(__dirname, '..');
+const REPO_ROOT = path.resolve(CLI_ROOT, '..');
+const TEMPLATE_DIR = path.join(CLI_ROOT, 'template');
+
+const DIRECTORIES = ['src', 'patches'];
+const FILES = ['.env.example'];
+
+function main() {
+  if (!fs.existsSync(path.join(REPO_ROOT, 'src'))) {
+    if (!fs.existsSync(path.join(TEMPLATE_DIR, 'src'))) {
+      console.error('❌ No starter src/ found next to cli/ and cli/template is empty.');
+      process.exit(1);
+    }
+    console.log('ℹ️  Starter repo not found next to cli/. Keeping the existing template.');
+    return;
+  }
+
+  fs.rmSync(TEMPLATE_DIR, { recursive: true, force: true });
+  fs.mkdirSync(TEMPLATE_DIR, { recursive: true });
+
+  for (const dir of DIRECTORIES) {
+    const from = path.join(REPO_ROOT, dir);
+    if (fs.existsSync(from)) {
+      copyDirectoryRecursive(from, path.join(TEMPLATE_DIR, dir));
+      console.log(`✅ template/${dir}`);
+    }
+  }
+
+  for (const file of FILES) {
+    const from = path.join(REPO_ROOT, file);
+    if (fs.existsSync(from)) {
+      fs.copyFileSync(from, path.join(TEMPLATE_DIR, file));
+      console.log(`✅ template/${file}`);
+    }
+  }
+
+  console.log('🎉 cli/template is up to date.');
+}
+
+main();

package/template/.env.example

@@ -0,0 +1,3 @@
+# Leave API_BASE_URL unset to use the built-in mock API (src/services/api/mock).
+# Set it to your backend URL to call the real server.
+# API_BASE_URL=https://api.example.com