feat: allow templating

Author: siddarthkay

.gitignore

@@ -60,10 +60,14 @@ backend/*.xcframework
 # IDEs
 .vscode/
 .idea/
+.claude/
 *.swp
 *.swo
 *~
 
+# CLI template (generated before npm publish)
+cli/template/
+
 # Testing
 coverage/
 *.log

README.md

@@ -26,6 +26,17 @@ This project showcases how to build a fast mobile application where:
 - iOS: Xcode 15+, CocoaPods
 - Android: Android Studio, JDK 17+
 
+## Create a New Project
+
+```bash
+npx create-react-native-go my-app --bundleId com.mycompany.myapp --goModule mycompany.com/my-app
+cd my-app
+make setup
+make ios    # or: make android
+```
+
+The CLI scaffolds a new project with your app name, bundle ID, and Go module — fully configured and ready to build.
+
 ## Quick Start
 
 ### Setup

cli/README.md

@@ -0,0 +1,62 @@
+# create-react-native-go
+
+Scaffold a React Native + Go mobile app in seconds. Go runs as an embedded HTTP server providing JSON-RPC APIs, while React Native handles the UI with the New Architecture (Fabric + TurboModules).
+
+## Usage
+
+```bash
+npx create-react-native-go my-app --bundleId com.mycompany.myapp --goModule mycompany.com/my-app
+cd my-app
+make setup
+make ios    # or: make android
+```
+
+If you omit any flags, the CLI will prompt you interactively.
+
+## What You Get
+
+```
+my-app/
+├── Makefile                        # Root orchestrator
+├── backend/
+│   ├── Makefile                    # Go build targets
+│   ├── mobile_api.go               # Mobile API for server lifecycle
+│   └── http_server.go              # JSON-RPC HTTP server
+└── mobile-app/
+    ├── Makefile                    # Mobile build targets
+    ├── src/
+    │   ├── NativeGoServerBridge.ts # TurboModule spec
+    │   ├── GoServerBridgeJSI.ts    # JSI wrapper
+    │   └── JsonRpcClient.ts        # JSON-RPC client
+    ├── android/                    # Android native code
+    └── ios/                        # iOS native code
+```
+
+## Prerequisites
+
+- Node.js 18+
+- Go 1.25+
+- iOS: Xcode 15+, CocoaPods
+- Android: Android Studio, JDK 17+
+
+## Options
+
+| Flag | Description | Example |
+|------|-------------|---------|
+| `--bundleId` | App bundle identifier | `com.mycompany.myapp` |
+| `--goModule` | Go module path | `mycompany.com/my-app` |
+
+The first positional argument is the app name (e.g. `my-app`).
+
+## How It Works
+
+The CLI copies a pre-built template and replaces all identifiers (app name, bundle ID, Go module path, iOS project name, Android package directories) to match your configuration. It then initializes a fresh git repo.
+
+## Links
+
+- [GitHub Repository](https://github.com/siddarthkay/react-native-go)
+- [Issues](https://github.com/siddarthkay/react-native-go/issues)
+
+## License
+
+MIT

cli/bin.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+const { run } = require("./src/index");
+run();

cli/build-template.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+# Copies project template files into cli/template/ for npm publishing.
+# Run this before `npm publish` in the cli/ directory.
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(dirname "$SCRIPT_DIR")"
+TEMPLATE_DIR="$SCRIPT_DIR/template"
+
+echo "Building template from repo..."
+
+rm -rf "$TEMPLATE_DIR"
+mkdir -p "$TEMPLATE_DIR"
+
+# Use rsync to copy while excluding build artifacts and dependencies
+rsync -a \
+  --exclude='.git' \
+  --exclude='node_modules' \
+  --exclude='Pods' \
+  --exclude='Podfile.lock' \
+  --exclude='*.xcworkspace' \
+  --exclude='build' \
+  --exclude='.gradle' \
+  --exclude='gradle/' \
+  --exclude='.yarn/cache' \
+  --exclude='.yarn/install-state.gz' \
+  --exclude='gobridge.aar' \
+  --exclude='Gobridge.xcframework' \
+  --exclude='go.sum' \
+  --exclude='.expo' \
+  --exclude='.cxx' \
+  --exclude='local.properties' \
+  "$REPO_ROOT/backend" "$TEMPLATE_DIR/"
+
+rsync -a \
+  --exclude='.git' \
+  --exclude='node_modules' \
+  --exclude='Pods' \
+  --exclude='Podfile.lock' \
+  --exclude='*.xcworkspace' \
+  --exclude='build' \
+  --exclude='.gradle' \
+  --exclude='.yarn/cache' \
+  --exclude='.yarn/install-state.gz' \
+  --exclude='gobridge.aar' \
+  --exclude='Gobridge.xcframework' \
+  --exclude='.expo' \
+  --exclude='.cxx' \
+  --exclude='.claude' \
+  --exclude='local.properties' \
+  "$REPO_ROOT/mobile-app" "$TEMPLATE_DIR/"
+
+cp "$REPO_ROOT/Makefile" "$TEMPLATE_DIR/Makefile"
+cp "$REPO_ROOT/.gitignore" "$TEMPLATE_DIR/.gitignore"
+
+echo "Template built at: $TEMPLATE_DIR"

cli/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "create-react-native-go",
+  "version": "1.0.1",
+  "description": "Create a React Native + Go mobile app",
+  "bin": {
+    "create-react-native-go": "./bin.js"
+  },
+  "scripts": {
+    "prepublishOnly": "./build-template.sh"
+  },
+  "files": [
+    "bin.js",
+    "src/",
+    "template/"
+  ],
+  "keywords": [
+    "react-native",
+    "golang",
+    "go",
+    "mobile",
+    "template",
+    "gomobile",
+    "jsi",
+    "turbomodules"
+  ],
+  "author": "siddarthkay",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/siddarthkay/react-native-go"
+  }
+}