feat: add Nix flake dev environment

.envrc

@@ -0,0 +1 @@
+use flake .

.gitignore

@@ -58,4 +58,7 @@ packages/react-devtools-extensions/.tempUserDataDir
 out
 
 # Cursor files
-.cursorrules
+.cursorrules
+
+# direnv local cache (committed: .envrc)
+.direnv

README.md

@@ -8,13 +8,36 @@ An Electron application with React and TypeScript
 
 ## Project Setup
 
-### Install
+### Using Nix (Recommended for NixOS users)
+
+With [direnv](https://direnv.net/) and [nix-direnv](https://github.com/nix-community/nix-direnv):
+
+```bash
+direnv allow   # one-time, auto-loads the flake on every cd
+npm install
+npm run dev
+```
+
+Without direnv:
+
+```bash
+nix develop
+npm install
+npm run dev
+```
+
+The flake provides a NixOS-patched Electron binary via `ELECTRON_EXEC_PATH`,
+so no `LD_LIBRARY_PATH` exports are needed.
+
+### Manual Setup
+
+#### Install
 
 ```bash
 $ npm install
 ```
 
-### Development
+#### Development
 
 ```bash
 $ npm run dev

flake.nix

@@ -0,0 +1,26 @@
+{
+  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+
+  outputs =
+    { nixpkgs, ... }:
+    let
+      systems = [
+        "x86_64-linux"
+        "aarch64-linux"
+      ];
+      forAllSystems = f: nixpkgs.lib.genAttrs systems (system: f nixpkgs.legacyPackages.${system});
+    in
+    {
+      devShells = forAllSystems (pkgs: {
+        default = pkgs.mkShell {
+          packages = [ pkgs.nodejs pkgs.electron ];
+          # Use the NixOS-patched Electron instead of the pre-built npm binary.
+          # pkgs.electron has correct RPATHs baked in, supports native Wayland
+          # (ozone/Chromium), and needs no LD_LIBRARY_PATH workarounds.
+          # electron-vite reads ELECTRON_EXEC_PATH before falling back to
+          # node_modules/electron/dist/electron.
+          ELECTRON_EXEC_PATH = "${pkgs.electron}/bin/electron";
+        };
+      });
+    };
+}