rn-branch-guard 0.1.0

package/bin/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const projectRoot = process.cwd();
+const hooksDir = path.join(projectRoot, ".githooks");
+const templateHook = path.join(__dirname, "..", "templates", "post-checkout");
+const targetHook = path.join(hooksDir, "post-checkout");
+
+function log(message) {
+  console.log(`[rn-branch-guard] ${message}`);
+}
+
+function ensureGitRepository() {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore" });
+  } catch {
+    log("This directory is not a Git repository.");
+    process.exit(1);
+  }
+}
+
+function ensureHooksDirectory() {
+  if (!fs.existsSync(hooksDir)) {
+    fs.mkdirSync(hooksDir, { recursive: true });
+    log("Created .githooks directory.");
+  }
+}
+
+function ensureTemplateExists() {
+  if (!fs.existsSync(templateHook)) {
+    log(`Template file not found: ${templateHook}`);
+    process.exit(1);
+  }
+}
+
+function installHook() {
+  fs.copyFileSync(templateHook, targetHook);
+  log("Installed post-checkout hook.");
+}
+
+function setHooksPath() {
+  try {
+    execSync("git config core.hooksPath .githooks", { stdio: "ignore" });
+    log("Configured Git hooks path to .githooks.");
+  } catch {
+    log("Failed to set Git hooks path.");
+    process.exit(1);
+  }
+}
+
+function main() {
+  ensureGitRepository();
+  ensureHooksDirectory();
+  ensureTemplateExists();
+  installHook();
+  setHooksPath();
+  log("Setup complete.");
+}
+
+main();

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "rn-branch-guard",
+  "version": "0.1.0",
+  "description": "Install a Git post-checkout hook that warns when dependency files change between branches.",
+  "bin": {
+    "rn-branch-guard": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "keywords": [
+    "react-native",
+    "expo",
+    "git-hooks",
+    "cli"
+  ],
+  "license": "MIT"
+}

package/readme.md

@@ -0,0 +1,22 @@
+# rn-branch-guard
+
+A tiny CLI that installs a Git `post-checkout` hook to warn you when dependency files change between branches.
+
+## Why?
+
+When switching branches in React Native / Expo projects, dependency files may change while your installed packages remain outdated. This often causes confusing build or runtime errors.
+
+`rn-branch-guard` helps by showing a warning after checkout when files like these change:
+
+- `package.json`
+- `package-lock.json`
+- `yarn.lock`
+- `pnpm-lock.yaml`
+
+## Usage
+
+Run this inside your project:
+
+```bash
+npx rn-branch-guard
+

package/templates/post-checkout

@@ -0,0 +1,11 @@
+#!/bin/sh
+
+CHANGED=$(git diff --name-only HEAD@{1} HEAD | grep -E "package.json|package-lock.json|yarn.lock|pnpm-lock.yaml")
+
+if [ -n "$CHANGED" ]; then
+  echo ""
+  echo "📦 Dependency files changed between branches."
+  echo "⚠️ Run your package manager install command."
+  echo "   Examples: npm install / yarn install / pnpm install"
+  echo ""
+fi