create-react-native-airborne 0.1.1 → 0.2.1

package/README.md

@@ -12,6 +12,9 @@ bun create react-native-airborne my-app
 
 - `--skip-install`: skip `bun install --workspaces`
 - `--no-git`: skip `git init`
+- `--nix`: include root-level `flake.nix`, `flake.lock`, and `.envrc`
+
+If you use `--nix`, run `direnv allow` after `cd` into the generated project.
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-react-native-airborne",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Scaffold a react-native-airborne starter project",
   "repository": {
     "type": "git",

package/src/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { mkdir, readdir, readFile, writeFile, copyFile, stat } from "node:fs/promises";
+import { mkdir, readdir, readFile, writeFile, copyFile, rm, stat } from "node:fs/promises";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -9,7 +9,9 @@ const flags = new Set(args.filter((arg) => arg.startsWith("--")));
 const projectNameArg = args.find((arg) => !arg.startsWith("--"));
 
 if (!projectNameArg) {
-  console.error("Usage: bun create react-native-airborne <project-name> [--skip-install] [--no-git]");
+  console.error(
+    "Usage: bun create react-native-airborne <project-name> [--skip-install] [--no-git] [--nix]",
+  );
   process.exit(1);
 }
 
@@ -18,6 +20,7 @@ const projectSlug = projectName.toLowerCase().replace(/[^a-z0-9-]/g, "-").replac
 const targetDir = path.resolve(process.cwd(), projectName);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const templateDir = path.resolve(__dirname, "../template");
+const enableNix = flags.has("--nix");
 
 async function exists(filePath) {
   try {
@@ -81,6 +84,13 @@ if (await exists(targetDir)) {
 await copyDirectory(templateDir, targetDir);
 await replaceTokens(targetDir);
 
+if (!enableNix) {
+  const optionalNixFiles = [".envrc", "flake.nix", "flake.lock"];
+  for (const file of optionalNixFiles) {
+    await rm(path.join(targetDir, file), { force: true });
+  }
+}
+
 if (!flags.has("--skip-install")) {
   const install = spawnSync("bun", ["install", "--workspaces"], {
     cwd: targetDir,
@@ -101,4 +111,7 @@ console.log("\nNext steps:");
 console.log(`  cd ${projectName}`);
 console.log("  cp client/.env.example client/.env");
 console.log("  cp server/.env.example server/.env");
+if (enableNix) {
+  console.log("  direnv allow");
+}
 console.log("  just dev");

package/template/.envrc

@@ -0,0 +1 @@
+use flake . --no-pure-eval

package/template/.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
           bun-version: "1.3.4"
 
       - name: "📦 Install dependencies"
-        run: bun install --workspaces
+        run: bun install --workspaces --frozen-lockfile
 
       - name: "🔍 Lint"
         run: |

package/template/README.md

@@ -1,94 +1,102 @@
-# React Native Airborne
+# __APP_NAME__
 
-Opinionated React Native starter for mobile-first apps with Expo + Convex.
+This project was scaffolded with React Native Airborne.
 
-## 🧰 Stack
+## 🧰 What You Get
 
 - Bun workspaces monorepo (`client/`, `server/`)
 - Expo + Expo Router + Native Tabs (SDK 55)
 - Uniwind + Tailwind v4
-- Clerk authentication
+- Clerk auth flows
 - Convex backend + `convex-test`
-- Zustand + MMKV persistence
+- Zustand + MMKV for non-sensitive local preferences
 - Expo push notifications
+- Strict ESLint + Prettier + tests
 
-## 🤝 Contributor Guide
+## 🗂️ Generated Project Layout
 
-Detailed implementation and maintenance notes for engineers/agents live in `AGENTS.md`.
+```text
+__APP_NAME__/
+  client/  # Expo app
+  server/  # Convex backend
+```
 
 ## ✅ Prerequisites
 
 - Bun `1.3.4+`
 - `just` command runner
-- Expo toolchain for iOS/Android simulators
-- Clerk app + Convex project
+- Expo toolchain for iOS/Android simulators/devices
+- Clerk app with native API enabled
+- Convex project/deployment
 
-## ⚡ Quickstart
+## ⚡ Quickstart (After Scaffolding)
 
 ```bash
+cd __APP_NAME__
 bun install --workspaces
 cp client/.env.example client/.env
 cp server/.env.example server/.env
 ```
 
-First-time Convex setup (one-time per new deployment):
+First-time Convex setup (once per deployment):
 
 ```bash
 cd server
 bun run dev
 ```
 
-Then run both apps:
+Then run app + backend together:
 
 ```bash
 just dev
 ```
 
-## 🧪 Commands
+## 🔐 Environment Variables
+
+Client (`client/.env`):
+
+- `EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY` (required)
+- `EXPO_PUBLIC_CONVEX_URL` (required)
+- `EXPO_PUBLIC_EAS_PROJECT_ID` (optional)
+
+Server (`server/.env`):
+
+- `CLERK_JWT_ISSUER_DOMAIN` (required in real environments)
+- `EXPO_PUSH_ENDPOINT` (optional)
+- `EXPO_ACCESS_TOKEN` (optional)
+
+## 🧪 Common Commands
 
 - `just dev`: start Expo + Convex
 - `just dev-client`: start Expo only
 - `just dev-server`: start Convex only
-- `just fmt`: run Prettier on client and server
-- `just prebuild`: generate local iOS/Android native folders
+- `just prebuild`: generate local iOS/Android folders
 - `just ios`: launch iOS app
 - `just android`: launch Android app
-- `just lint`: lint/type lint checks
+- `just fmt`: format client/server
+- `just lint`: lint checks
 - `just typecheck`: TypeScript checks
 - `just test`: client + server tests
-- `just test-client`: client tests only
-- `just test-server`: server tests only
 - `just ci`: lint + typecheck + tests
 
-## 📱 Native Projects
+## 📱 Native Folder Policy
 
-Generate native projects locally when needed:
+`just prebuild` is supported for local native runs.  
+`client/ios` and `client/android` are generated locally and should not be committed.
 
-```bash
-just prebuild
-```
-
-`client/ios` and `client/android` are intentionally gitignored and should not be committed.
-
-## 🔐 Environment Variables
-
-### Client (`client/.env`)
+## 📝 Notes
 
-- `EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY`
-- `EXPO_PUBLIC_CONVEX_URL`
-- `EXPO_PUBLIC_EAS_PROJECT_ID` (optional)
+- Theme support is built-in for `light`, `dark`, and `system`.
+- Do not store sensitive auth/session tokens in MMKV.
+- Uniwind is configured via `client/global.css` and `client/metro.config.js`.
+- `SafeAreaView` is wrapped with `withUniwind` in `client/src/components/screen.tsx`.
+- `server/convex/_generated` ships with starter stubs; after connecting Convex, run `cd server && bun run codegen`.
+- `.direnv/` is gitignored by default.
 
-### Server (`server/.env`)
+## 🤝 Contributing
 
-- `CLERK_JWT_ISSUER_DOMAIN`
-- `EXPO_PUSH_ENDPOINT` (optional)
-- `EXPO_ACCESS_TOKEN` (optional)
+See `AGENTS.md` for implementation notes and project conventions.
 
-## 📝 Notes
+## 📄 License
 
-- Mobile-only target (iOS/Android).
-- Do not store sensitive auth tokens in MMKV.
-- Uniwind classes are enabled by `client/global.css` and `client/metro.config.js`.
-- `SafeAreaView` is wrapped with `withUniwind` in `client/src/components/screen.tsx` for className support.
-- `server/convex/_generated` ships with starter stubs so typecheck/tests pass before deployment setup.
-  After connecting Convex, run `cd server && bun run codegen` to regenerate.
+MIT

package/template/flake.lock

@@ -0,0 +1,104 @@
+{
+  "nodes": {
+    "android-nixpkgs": {
+      "inputs": {
+        "devshell": "devshell",
+        "flake-utils": "flake-utils",
+        "nixpkgs": [
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1770842373,
+        "narHash": "sha256-uCxNWY8xGGtk8YwDJXsfpKUYw8GqR/3degPbIthtFTE=",
+        "owner": "tadfisher",
+        "repo": "android-nixpkgs",
+        "rev": "12878f0d54f923dff305b71d04c6d837df8ce5ab",
+        "type": "github"
+      },
+      "original": {
+        "owner": "tadfisher",
+        "repo": "android-nixpkgs",
+        "type": "github"
+      }
+    },
+    "devshell": {
+      "inputs": {
+        "nixpkgs": [
+          "android-nixpkgs",
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1768818222,
+        "narHash": "sha256-460jc0+CZfyaO8+w8JNtlClB2n4ui1RbHfPTLkpwhU8=",
+        "owner": "numtide",
+        "repo": "devshell",
+        "rev": "255a2b1725a20d060f566e4755dbf571bbbb5f76",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "devshell",
+        "type": "github"
+      }
+    },
+    "flake-utils": {
+      "inputs": {
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1731533236,
+        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1770843696,
+        "narHash": "sha256-LovWTGDwXhkfCOmbgLVA10bvsi/P8eDDpRudgk68HA8=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "2343bbb58f99267223bc2aac4fc9ea301a155a16",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixpkgs-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "android-nixpkgs": "android-nixpkgs",
+        "nixpkgs": "nixpkgs"
+      }
+    },
+    "systems": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

package/template/flake.nix

@@ -0,0 +1,164 @@
+{
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+
+    android-nixpkgs = {
+      url = "github:tadfisher/android-nixpkgs";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+  };
+
+  outputs =
+    {
+      self,
+      nixpkgs,
+      android-nixpkgs,
+    }:
+    let
+      systems = [
+        "aarch64-darwin"
+        "x86_64-linux"
+      ];
+      forAllSystems = nixpkgs.lib.genAttrs systems;
+
+      pkgsFor =
+        system:
+        import nixpkgs {
+          inherit system;
+          config = {
+            allowUnfree = true;
+            android_sdk.accept_license = true;
+          };
+        };
+
+      androidSdkFor =
+        system:
+        android-nixpkgs.sdk.${system} (
+          sdkPkgs: with sdkPkgs; [
+            cmdline-tools-latest
+            build-tools-35-0-0
+            build-tools-36-0-0
+            platform-tools
+            platforms-android-35
+            platforms-android-36
+            ndk-27-1-12297006
+            ndk-27-0-12077973
+            cmake-3-22-1
+          ]
+        );
+
+      darwinDerivations = {
+        xcode-wrapper =
+          pkgs:
+          pkgs.stdenv.mkDerivation {
+            name = "xcode-wrapper-16.4.0";
+            buildInputs = [ pkgs.darwin.cctools ];
+            buildCommand = ''
+              mkdir -p $out/bin
+
+              cat > $out/bin/xcodebuild << EOF
+              #!/bin/sh
+              exec /usr/bin/xcodebuild "\$@"
+              EOF
+
+              cat > $out/bin/xcrun << EOF
+              #!/bin/sh
+              exec /usr/bin/xcrun "\$@"
+              EOF
+
+              cat > $out/bin/xcode-select << EOF
+              #!/bin/sh
+              if [ "\$1" = "-p" ] && [ -n "\$DEVELOPER_DIR" ]; then
+                echo "\$DEVELOPER_DIR"
+              else
+                exec /usr/bin/xcode-select "\$@"
+              fi
+              EOF
+
+              cat > $out/bin/codesign << EOF
+              #!/bin/sh
+              exec /usr/bin/codesign "\$@"
+              EOF
+
+              cat > $out/bin/ld << EOF
+              #!/bin/sh
+              exec /usr/bin/ld "\$@"
+              EOF
+
+              cat > $out/bin/clang << EOF
+              #!/bin/sh
+              exec /usr/bin/clang "\$@"
+              EOF
+
+              chmod +x $out/bin/*
+
+              if [ -d "/Applications/Xcode.app" ]; then
+                DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
+              elif [ -d "/Applications/Xcode-16.4.0.app" ]; then
+                DEVELOPER_DIR="/Applications/Xcode-16.4.0.app/Contents/Developer"
+              else
+                echo "Error: Xcode not found"
+                exit 1
+              fi
+
+              echo "export DEVELOPER_DIR=\"$DEVELOPER_DIR\"" > $out/bin/env.sh
+            '';
+          };
+
+      };
+
+      mkShellFor =
+        system:
+        let
+          pkgs = pkgsFor system;
+          androidSdk = androidSdkFor system;
+          basePackages = with pkgs; [
+            androidSdk
+            bun
+            just
+          ];
+
+          darwinPackages = with pkgs; [
+            bundler
+            cocoapods
+            (darwinDerivations.xcode-wrapper pkgs)
+          ];
+
+          darwinHook = ''
+            export LC_ALL=en_US.UTF-8
+            export LANG=en_US.UTF-8
+            export JAVA_HOME="${pkgs.jdk17.home}"
+
+            unset SDKROOT
+
+            if [ -f "${darwinDerivations.xcode-wrapper pkgs}/bin/env.sh" ]; then
+              source "${darwinDerivations.xcode-wrapper pkgs}/bin/env.sh"
+            fi
+
+            export LD=/usr/bin/clang
+            export LD_FOR_TARGET=/usr/bin/clang
+
+            echo "iOS development environment:"
+            echo "DEVELOPER_DIR: $DEVELOPER_DIR"
+            xcodebuild -version
+          '';
+
+          linuxHook = ''
+            export LC_ALL=en_US.UTF-8
+            export LANG=en_US.UTF-8
+            export JAVA_HOME="${pkgs.jdk17.home}"
+          '';
+
+        in
+        pkgs.mkShellNoCC {
+          buildInputs = if system == "aarch64-darwin" then basePackages ++ darwinPackages else basePackages;
+
+          shellHook = if system == "aarch64-darwin" then darwinHook else linuxHook;
+        };
+    in
+    {
+      devShells = forAllSystems (system: {
+        default = mkShellFor system;
+      });
+    };
+}

package/template/gitignore

@@ -25,3 +25,4 @@ coverage/
 # macOS
 .DS_Store
 .npmrc
+.direnv/

package/template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "__APP_NAME__",
-  "version": "0.1.1",
+  "version": "0.1.0",
   "private": true,
   "packageManager": "bun@1.3.4",
   "workspaces": [