diff --git a/default.nix b/default.nix
new file mode 100644
index 0000000000..e0f1cb0d23
--- /dev/null
+++ b/default.nix
@@ -0,0 +1,65 @@
+{
+  pkgs ? import <nixpkgs> {},
+  system ? builtins.currentSystem,
+  sha256 ? null,
+}: let
+  packageJson = builtins.fromJSON (builtins.readFile ./package.json);
+  nodeVersion = builtins.replaceStrings ["^" "~"] ["" ""] packageJson.engines.node;
+  pnpmVersion = builtins.head (builtins.match "pnpm@([0-9.]+).*" packageJson.packageManager);
+
+  getPlatformString = platform:
+    if platform == "nodejs"
+    then
+      if pkgs.stdenv.isDarwin
+      then
+        if pkgs.stdenv.isAarch64
+        then "darwin-arm64"
+        else "darwin-x64"
+      else if pkgs.stdenv.isAarch64
+      then "linux-arm64"
+      else "linux-x64"
+    else if pkgs.stdenv.isDarwin
+    then
+      if pkgs.stdenv.isAarch64
+      then "macos-arm64"
+      else "macos-x64"
+    else if pkgs.stdenv.isAarch64
+    then "linux-arm64"
+    else "linux-x64";
+in rec {
+  buildNodePackages = pkgs: {
+    nodejs = pkgs.stdenv.mkDerivation {
+      name = "nodejs-${nodeVersion}";
+      src = pkgs.fetchurl {
+        url = "https://nodejs.org/dist/v${nodeVersion}/node-v${nodeVersion}-${getPlatformString "nodejs"}.tar.xz";
+        inherit sha256;
+      };
+      buildInputs = [pkgs.python3];
+      sourceRoot = ".";
+      dontUnpack = false;
+      dontBuild = true;
+      installPhase = ''
+        mkdir -p $out
+        mv node-v${nodeVersion}-* node
+        cp -r node/* $out/
+        chmod +x $out/bin/node
+        ln -s $out/bin/node $out/bin/nodejs
+      '';
+    };
+
+    pnpm = pkgs.stdenv.mkDerivation {
+      name = "pnpm-${pnpmVersion}";
+      src = pkgs.fetchurl {
+        url = "https://github.com/pnpm/pnpm/releases/download/v${pnpmVersion}/pnpm-${getPlatformString "pnpm"}";
+        inherit sha256;
+      };
+      dontUnpack = true;
+      dontStrip = true;
+      installPhase = ''
+        mkdir -p $out/bin
+        cp $src $out/bin/pnpm
+        chmod +x $out/bin/pnpm
+      '';
+    };
+  };
+}
diff --git a/flake.lock b/flake.lock
new file mode 100644
index 0000000000..23d0fa5b4e
--- /dev/null
+++ b/flake.lock
@@ -0,0 +1,60 @@
+{
+  "nodes": {
+    "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": 1734697167,
+        "narHash": "sha256-EbZvfBE8kbaZsDU7X66ewsmQAZ2n/h469/av96EIEK0=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "49fbcc0956cfee730d82e50c408fd4b777b882f0",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "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
+}
diff --git a/flake.nix b/flake.nix
new file mode 100644
index 0000000000..df7cd60e67
--- /dev/null
+++ b/flake.nix
@@ -0,0 +1,112 @@
+{
+  description = "Node.js development environment with NVM and PNPM";
+
+  inputs = {
+    nixpkgs.url = "github:nixos/nixpkgs";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = {
+    self,
+    nixpkgs,
+    flake-utils,
+  }:
+    flake-utils.lib.eachDefaultSystem (system: let
+      pkgs = nixpkgs.legacyPackages.${system};
+      fallbackNodeVersion = "23.3.0";
+      fallbackPnpmVersion = "9.14.4";
+
+      # Read and parse package.json
+      packageJson = let
+        path = ./package.json;
+      in
+        if builtins.pathExists path
+        then builtins.fromJSON (builtins.readFile path)
+        else {
+          engines = {node = fallbackNodeVersion;};
+          packageManager = "pnpm@${fallbackPnpmVersion}";
+        }; # Default if no package.json
+
+      # Extract Node.js version from engines field
+      nodeVersion = let
+        engineVersion = packageJson.engines.node or fallbackNodeVersion;
+        cleanVersion = builtins.replaceStrings ["^" ">" "=" "~" " "] ["" "" "" "" ""] engineVersion;
+      in
+        cleanVersion;
+
+      # Extract PNPM version from packageManager field
+      # Handles format: "pnpm@x.y.z+sha512..." or "pnpm@x.y.z"
+      pnpmVersion = let
+        packageManager = packageJson.packageManager or "pnpm@${fallbackPnpmVersion}";
+        # First split on '+' to remove SHA, then extract version
+        withoutSha = builtins.head (builtins.split "[+]" packageManager);
+        versionMatch = builtins.match "pnpm@([0-9]+[.][0-9]+[.][0-9]+).*" withoutSha;
+      in
+        if versionMatch == null
+        then fallbackPnpmVersion
+        else builtins.head versionMatch;
+    in {
+      devShell = pkgs.mkShell {
+        buildInputs = with pkgs; [
+          curl
+          git
+        ];
+
+        shellHook = ''
+          # Install nvm if it's not already installed
+          export NVM_DIR="$HOME/.nvm"
+          if [ ! -d "$NVM_DIR" ]; then
+            curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
+          fi
+
+          # Load nvm
+          [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+          # Install and use the specified version if not already installed
+          if ! nvm ls ${nodeVersion} >/dev/null 2>&1; then
+            nvm install ${nodeVersion}
+          fi
+          nvm use ${nodeVersion}
+
+          # Enable and configure corepack for PNPM
+          corepack enable
+          corepack prepare pnpm@${pnpmVersion} --activate
+
+          # Setup PNPM environment
+          export PNPM_HOME="$HOME/.local/share/pnpm"
+          export PATH="$PNPM_HOME:$PATH"
+
+          # Get clean versions for comparison
+          NODE_ACTUAL=$(node --version | sed 's/^v//')
+          PNPM_ACTUAL=$(pnpm --version)
+
+          echo "🤖 Development environment loaded 🚀"
+          echo "------------------------------------------"
+          echo "package.json version(s) = environment:"
+
+          if [ "$NODE_ACTUAL" = "${nodeVersion}" ]; then
+            echo "✅ Node.js (v${nodeVersion})"
+          else
+            echo "❌ Node.js (v${nodeVersion} != v$NODE_ACTUAL)"
+          fi
+
+          if [ "$PNPM_ACTUAL" = "${pnpmVersion}" ]; then
+            echo "✅ PNPM (v${pnpmVersion})"
+          else
+            echo "❌ PNPM (v${pnpmVersion} != v$PNPM_ACTUAL)"
+          fi
+
+          echo """
+          🏗️  Quickstart Guide:
+          --------------------
+          ┌─> 1. pnpm i      (Install dependencies)
+          │   2. pnpm build  (Build project)
+          └─  3. pnpm clean  (Clear Artifacts, for a fresh start)
+              4. pnpm test   (Run tests)
+
+          For more commands, run: pnpm --help
+          """
+        '';
+      };
+    });
+}