create-insystem-native-app 0.0.1

package/README.md

@@ -0,0 +1,86 @@
+# create-insystem-native-app
+
+INSYSTEM 하이브리드 앱 보일러플레이트(Expo + WebView)를 클론해 새 프로젝트를 만듭니다.
+
+웹 서비스를 그대로 두고 Android·iOS 앱으로 감싸는 네이티브 셸입니다.
+푸시 알림, 딥링크, 외부 결제창, 웹↔네이티브 브리지가 들어 있습니다.
+
+`create-insystem-nest-app` 과 같은 방식입니다.
+
+## 사용법
+
+```bash
+npx create-insystem-native-app ./my-app
+```
+
+```bash
+create-insystem-native-app <target-dir> [options]
+```
+
+| 옵션 | 설명 |
+| --- | --- |
+| `--branch <branch>` | 클론할 브랜치 (기본 `template`) |
+| `--repo <url>` | 템플릿 git 주소 |
+| `--no-install` | 의존성 설치 건너뛰기 |
+| `--no-env` | `.env.example` → `.env` 복사 건너뛰기 |
+| `--git` | 클론 후 새 git 저장소로 초기화 |
+| `-h`, `--help` | 도움말 |
+
+## 하는 일
+
+1. `insystem-dev01/insystem-shop-web-app` 의 **`template` 브랜치**를 `--depth 1` 로 클론
+2. `.git` 제거 (새 프로젝트는 자기 히스토리로 시작)
+3. `.env.example` → `.env` 복사
+4. 의존성 설치 (npm/yarn/pnpm/bun 자동 감지)
+5. 다음 단계 안내 출력
+
+> ⚠️ **기본 브랜치가 `main` 이 아니라 `template` 입니다.**
+> 이 저장소의 `main` 은 인시스템 마트 고객앱의 실제 배포본이라
+> 브랜드·패키지명·Firebase 설정이 들어 있습니다. 새 고객사 시작점으로는 맞지 않습니다.
+> 마트 앱 자체를 복제해야 한다면 `--branch main` 을 쓰세요.
+
+## 클론 후 반드시 할 일
+
+**① `.env` 수정** — 이 값이 없으면 앱이 띄울 웹 주소를 몰라 실행되지 않습니다.
+
+```bash
+EXPO_PUBLIC_WEB_APP_URL=https://shop.example.com   # 필수
+APP_DISPLAY_NAME=고객사 앱 이름
+APP_SCHEME=customerapp                              # 딥링크 스킴
+ANDROID_PACKAGE=kr.example.customer
+IOS_BUNDLE_IDENTIFIER=kr.example.customer
+```
+
+> 실기기에서 개발 서버를 볼 때 `localhost` 는 **휴대폰 자신**을 가리킵니다.
+> 개발 PC 의 LAN IP 를 넣으세요. (안드로이드 에뮬레이터는 `http://10.0.2.2:3000`)
+
+**② 푸시를 쓴다면 Firebase 파일 배치**
+
+```
+config/firebase/google-services.json        (Android)
+config/firebase/GoogleService-Info.plist    (iOS)
+```
+
+🚨 이 파일들은 **고객사마다 다르고 저장소에 커밋되지 않습니다**(`.gitignore` 처리됨).
+빌드 시점에 넣어 주세요.
+
+**③ 실행**
+
+```bash
+npm start                  # Expo 개발 서버
+npm run android            # Android 실행
+npm run build:apk:android  # Metro 없이 도는 Standalone APK
+```
+
+자세한 내용은 클론된 프로젝트의 `README.md` 와 `docs/` 를 보세요.
+
+## 사전 준비
+
+- Node.js 18 이상, Git
+- Android: JDK 17, Android Studio/SDK, `adb`
+- iOS: macOS, Xcode, CocoaPods
+
+## 관련
+
+- 템플릿 저장소: <https://github.com/insystem-dev01/insystem-shop-web-app>
+- 백엔드 보일러플레이트: `create-insystem-nest-app`

package/index.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+/**
+ * create-insystem-native-app
+ *
+ * INSYSTEM 하이브리드 앱 보일러플레이트(`insystem-shop-web-app`)를 클론해
+ * 새 고객사용 프로젝트를 만듭니다.
+ *
+ * `create-insystem-nest-app` 과 같은 구조입니다 — git clone 후 히스토리를 지우고
+ * 의존성을 설치합니다. 다른 점은 아래 두 가지입니다.
+ *
+ *   1. 기본 브랜치가 `template` 입니다. 이 저장소의 `main` 은 인시스템 마트 앱의
+ *      실제 배포본이라 다른 고객사가 그대로 쓰면 안 됩니다.
+ *   2. 클론 후 `.env.example` → `.env` 를 만들어 줍니다. 이 앱은 `.env` 없이는
+ *      WebView 주소를 몰라 실행 자체가 되지 않습니다.
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const DEFAULT_REPO =
+    'https://github.com/insystem-dev01/insystem-shop-web-app.git';
+
+/**
+ * 🚨 기본 브랜치를 `main` 이 아니라 `template` 로 둡니다.
+ *    `main` 에는 마트 앱의 브랜드·식별자가 들어 있어 새 고객사 시작점으로 맞지 않습니다.
+ */
+const DEFAULT_BRANCH = 'template';
+
+function printHelpAndExit(exitCode = 0) {
+    console.log(`
+Usage:
+  create-insystem-native-app <target-dir> [options]
+  create-insystem-native-app -h | --help
+
+Options:
+  --branch <branch>  클론할 브랜치 (기본: ${DEFAULT_BRANCH})
+  --repo <url>       템플릿 git 주소 (기본: 인시스템 하이브리드 앱 보일러플레이트)
+  --no-install       의존성 설치 건너뛰기
+  --no-env           .env.example 복사 건너뛰기
+  --git              클론 후 새 git 저장소로 초기화
+  -h, --help         도움말
+
+Examples:
+  npx create-insystem-native-app ./my-shop-app
+  npx create-insystem-native-app ./my-shop-app --branch main
+  npx create-insystem-native-app ./my-shop-app --no-install
+  npx create-insystem-native-app ./my-shop-app --git
+`);
+    process.exit(exitCode);
+}
+
+function hasCmd(cmd) {
+    try {
+        execSync(
+            process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`,
+            { stdio: 'ignore' },
+        );
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+function parseArgs(argv) {
+    const args = {
+        repo: DEFAULT_REPO,
+        branch: DEFAULT_BRANCH,
+        noInstall: false,
+        noEnv: false,
+        initGit: false,
+    };
+    const rest = [];
+
+    for (let i = 2; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--branch') {
+            args.branch = argv[++i];
+        } else if (a === '--repo') {
+            args.repo = argv[++i];
+        } else if (a === '--no-install') {
+            args.noInstall = true;
+        } else if (a === '--no-env') {
+            args.noEnv = true;
+        } else if (a === '--git') {
+            args.initGit = true;
+        } else if (a === '--no-git') {
+            args.initGit = false;
+        } else if (a === '-h' || a === '--help') {
+            printHelpAndExit(0);
+        } else {
+            rest.push(a);
+        }
+    }
+
+    if (rest.length < 1) printHelpAndExit(1);
+    args.target = rest[0];
+    return args;
+}
+
+function ensureDirReady(targetAbs) {
+    if (fs.existsSync(targetAbs)) {
+        const stat = fs.statSync(targetAbs);
+        if (!stat.isDirectory()) {
+            console.error(`❌ 대상이 폴더가 아닙니다: ${targetAbs}`);
+            process.exit(1);
+        }
+        const files = fs
+            .readdirSync(targetAbs)
+            .filter((f) => f !== '.git' && f !== '.gitkeep');
+        if (files.length > 0) {
+            console.error(`❌ 대상 폴더가 비어 있지 않습니다: ${targetAbs}`);
+            console.error('   빈 폴더 또는 새 경로를 지정하세요.');
+            process.exit(1);
+        }
+    } else {
+        fs.mkdirSync(targetAbs, { recursive: true });
+    }
+}
+
+function removeGitFolder(targetAbs) {
+    const gitPath = path.join(targetAbs, '.git');
+    if (fs.existsSync(gitPath)) {
+        fs.rmSync(gitPath, { recursive: true, force: true });
+    }
+}
+
+/**
+ * `.env.example` → `.env`
+ *
+ * 이 앱은 `EXPO_PUBLIC_WEB_APP_URL` 이 없으면 띄울 웹 주소를 모릅니다.
+ * 값 자체는 고객사마다 다르므로 예시를 그대로 복사만 하고, 수정은 사용자가 합니다.
+ */
+function copyEnvExample(targetAbs) {
+    const example = path.join(targetAbs, '.env.example');
+    const dest = path.join(targetAbs, '.env');
+
+    if (!fs.existsSync(example)) return false;
+    if (fs.existsSync(dest)) return false;
+
+    fs.copyFileSync(example, dest);
+    return true;
+}
+
+function detectPkgManager() {
+    const ua = process.env.npm_config_user_agent || '';
+    if (ua.startsWith('pnpm/')) return 'pnpm';
+    if (ua.startsWith('yarn/')) return 'yarn';
+    if (ua.startsWith('bun/')) return 'bun';
+    if (ua.startsWith('npm/')) return 'npm';
+
+    if (hasCmd('pnpm')) return 'pnpm';
+    if (hasCmd('yarn')) return 'yarn';
+    if (hasCmd('bun')) return 'bun';
+    return 'npm';
+}
+
+/** Windows 에서 npm/yarn/pnpm 은 .cmd 스크립트라 shell 이 필요합니다. */
+function getPkgManagerRunArgs(pm) {
+    const isWin = process.platform === 'win32';
+    const cmd = isWin
+        ? { npm: 'npm.cmd', yarn: 'yarn.cmd', pnpm: 'pnpm.cmd', bun: 'bun' }[pm] || pm
+        : pm;
+    const args = pm === 'yarn' ? [] : ['install'];
+    return { cmd, args, shell: isWin };
+}
+
+function run(cmd, args, opts = {}) {
+    const res = spawnSync(cmd, args, { stdio: 'inherit', shell: false, ...opts });
+    if (res.status !== 0) {
+        console.error(`❌ 명령 실패: ${cmd} ${args.join(' ')}`);
+        process.exit(res.status || 1);
+    }
+}
+
+(function main() {
+    const args = parseArgs(process.argv);
+
+    if (!hasCmd('git')) {
+        console.error('❌ Git 이 설치되어 있지 않거나 PATH 에 없습니다.');
+        process.exit(1);
+    }
+
+    const targetAbs = path.resolve(process.cwd(), args.target);
+    ensureDirReady(targetAbs);
+
+    // 1) 클론
+    console.log(`🚚 템플릿을 클론합니다... (${args.branch})`);
+    const cloneArgs = ['clone', '--depth', '1', '-b', args.branch, args.repo, targetAbs];
+    run('git', cloneArgs);
+
+    // 2) 히스토리 제거 — 새 프로젝트는 자기 히스토리로 시작합니다
+    removeGitFolder(targetAbs);
+
+    // 3) .env 준비
+    let envCreated = false;
+    if (!args.noEnv) {
+        envCreated = copyEnvExample(targetAbs);
+        if (envCreated) console.log('📝 .env.example 을 .env 로 복사했습니다.');
+    }
+
+    // 4) git 초기화 (--git 일 때만)
+    if (args.initGit) {
+        console.log('🔧 새 Git 저장소를 초기화합니다...');
+        run('git', ['init'], { cwd: targetAbs });
+        run('git', ['add', '.'], { cwd: targetAbs });
+        run('git', ['commit', '-m', 'chore: init from insystem hybrid app template'], {
+            cwd: targetAbs,
+        });
+        run('git', ['branch', '-M', 'main'], { cwd: targetAbs });
+    }
+
+    // 5) 의존성 설치
+    const pm = detectPkgManager();
+    if (!args.noInstall) {
+        console.log(`📦 ${pm} 로 의존성을 설치합니다...`);
+        const { cmd, args: pmArgs, shell } = getPkgManagerRunArgs(pm);
+        run(cmd, pmArgs, { cwd: targetAbs, shell });
+    } else {
+        console.log('⏭  의존성 설치를 건너뜁니다 (--no-install).');
+    }
+
+    // 6) 다음 단계 안내
+    const shownPath = path.relative(process.cwd(), targetAbs) || '.';
+    console.log('\n✅ 완료!');
+    console.log('\n다음 단계:');
+    console.log(`  cd ${shownPath}`);
+    if (args.noInstall) console.log(`  ${pm} install`);
+
+    console.log('\n  1) .env 를 고객사에 맞게 수정하세요');
+    if (!envCreated && !args.noEnv) {
+        console.log('     ⚠️  .env 가 이미 있거나 .env.example 이 없어 복사하지 않았습니다.');
+    }
+    console.log('     EXPO_PUBLIC_WEB_APP_URL  WebView 로 띄울 웹 주소 (필수)');
+    console.log('     APP_DISPLAY_NAME / APP_SCHEME');
+    console.log('     ANDROID_PACKAGE / IOS_BUNDLE_IDENTIFIER');
+    console.log('\n  2) 푸시를 쓴다면 고객사 Firebase 파일을 넣으세요');
+    console.log('     config/firebase/google-services.json  (저장소에 커밋되지 않습니다)');
+    console.log('\n  3) 실행');
+    console.log(`     ${pm} start                  Expo 개발 서버`);
+    console.log(`     ${pm} run android            Android 실행`);
+    console.log(`     ${pm} run build:apk:android  Standalone APK 빌드`);
+    console.log('\n  자세한 내용은 클론된 프로젝트의 README.md 를 보세요.');
+})();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-insystem-native-app",
+  "version": "0.0.1",
+  "description": "Clone the INSYSTEM hybrid app (Expo + WebView) boilerplate and bootstrap a new project",
+  "bin": {
+    "create-insystem-native-app": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "license": "MIT",
+  "author": "eastzoo",
+  "homepage": "https://github.com/insystem-dev01/insystem-shop-web-app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/insystem-dev01/insystem-shop-web-app.git"
+  },
+  "bugs": {
+    "url": "https://github.com/insystem-dev01/insystem-shop-web-app/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "create",
+    "scaffold",
+    "boilerplate",
+    "expo",
+    "react-native",
+    "webview",
+    "hybrid",
+    "insystem",
+    "eastzoo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}