create-react-native-airborne 0.1.0 → 0.2.0

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.0",
+  "version": "0.2.0",
   "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 {
@@ -34,7 +37,8 @@ async function copyDirectory(src, dest) {
 
   for (const entry of entries) {
     const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
+    const destName = entry.name === "gitignore" ? ".gitignore" : entry.name;
+    const destPath = path.join(dest, destName);
 
     if (entry.isDirectory()) {
       await copyDirectory(srcPath, destPath);
@@ -80,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,
@@ -100,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,6 +1,8 @@
 # React Native Airborne
 
-Opinionated React Native starter for mobile-first apps with Expo + Convex.
+React Native Airborne my opinionated mobile starter for folks who want to ship iOS/Android apps fast without repeating the same setup every project.
+
+It includes a production-ready Expo client and a Convex backend.
 
 ## 🧰 Stack
 
@@ -11,17 +13,31 @@ Opinionated React Native starter for mobile-first apps with Expo + Convex.
 - Convex backend + `convex-test`
 - Zustand + MMKV persistence
 - Expo push notifications
+- Strict ESLint + Prettier setup
 
-## 🤝 Contributor Guide
+## 🎯 Opinionated Defaults
 
-Detailed implementation and maintenance notes for engineers/agents live in `AGENTS.md`.
+- Mobile-only target (iOS/Android), no web target in starter scope.
+- Expo prebuild supported for local native debugging, but `client/ios` and `client/android` are not committed.
+- Clerk + Convex integration wired from day one.
+- Theme system includes `light`, `dark`, and `system` with persisted preference.
+- Auth tokens are kept in secure storage flows, not MMKV.
+
+## 🗂️ Project Layout
+
+```text
+__APP_NAME__/
+  client/ # Expo app (Expo Router + Native Tabs)
+  server/ # Convex backend
+```
 
 ## ✅ Prerequisites
 
 - Bun `1.3.4+`
 - `just` command runner
 - Expo toolchain for iOS/Android simulators
-- Clerk app + Convex project
+- Clerk app configured for native API
+- Convex project/deployment
 
 ## ⚡ Quickstart
 
@@ -38,7 +54,7 @@ cd server
 bun run dev
 ```
 
-Then run both apps:
+Run both client and server:
 
 ```bash
 just dev
@@ -53,7 +69,7 @@ just dev
 - `just prebuild`: generate local iOS/Android native folders
 - `just ios`: launch iOS app
 - `just android`: launch Android app
-- `just lint`: lint/type lint checks
+- `just lint`: lint checks
 - `just typecheck`: TypeScript checks
 - `just test`: client + server tests
 - `just test-client`: client tests only
@@ -72,23 +88,26 @@ just prebuild
 
 ## 🔐 Environment Variables
 
-### Client (`client/.env`)
+Client (`client/.env`):
 
 - `EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY`
 - `EXPO_PUBLIC_CONVEX_URL`
 - `EXPO_PUBLIC_EAS_PROJECT_ID` (optional)
 
-### Server (`server/.env`)
+Server (`server/.env`):
 
 - `CLERK_JWT_ISSUER_DOMAIN`
 - `EXPO_PUSH_ENDPOINT` (optional)
 - `EXPO_ACCESS_TOKEN` (optional)
 
+## 🤝 Contributor Guide
+
+Detailed implementation and maintenance notes for engineers/agents live in `AGENTS.md`.
+
 ## 📝 Notes
 
-- 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.
+- After connecting Convex, run `cd server && bun run codegen` to regenerate server types.
+- `.direnv/` is gitignored by default.

package/template/client/gitignore

@@ -0,0 +1,43 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+app-example
+
+# generated native folders
+/ios
+/android

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

@@ -0,0 +1,28 @@
+# dependencies
+node_modules/
+
+# logs
+*.log
+
+# expo
+.expo/
+.expo-shared/
+client/.expo/
+
+# native folders (generated locally via prebuild)
+client/ios/
+client/android/
+
+# test/build artifacts
+coverage/
+*.tsbuildinfo
+
+# env files
+.env
+.env.*
+!.env.example
+
+# macOS
+.DS_Store
+.npmrc
+.direnv/

package/template/server/gitignore

@@ -0,0 +1,2 @@
+
+.env.local