Add interactive REPL with helpers and improve package management

- Add Node.js to devshell for mature, stable REPL
- Create .replrc.js with println() and dir() helpers
- Add 'just repl' command with auto-loaded helpers
- Add 'just add-dev' and 'just remove' for package management
- Update README with complete command reference and feature list

.replrc.js

@@ -0,0 +1,5 @@
+// REPL helper functions
+// Loaded automatically by `just repl`
+
+globalThis.println = (...args) => console.log(...args);
+globalThis.dir = (obj) => console.dir(obj, { depth: null, colors: true });

Justfile

@@ -6,6 +6,10 @@ default:
 dev:
     bun run dev
 
+# Start interactive REPL with auto-loaded helpers
+repl:
+    node --eval "await import('./.replrc.js')" -i
+
 # Add a package dependency
 add package:
     bun add {{package}}
@@ -34,6 +38,10 @@ install:
 update:
     nix flake update
 
+# Upgrade package dependencies
+upgrade:
+    bun update
+
 # Clean build artifacts and dependencies
 clean:
     rm -rf dist node_modules bun.lockb

README.md

@@ -3,8 +3,9 @@
 A minimal JavaScript development template using Nix. Key features:
 
 - Nix + Flakes for reproducible environments
-- Bun (fast JavaScript runtime)
+- Bun (fast JavaScript runtime & package manager)
 - Vite (development server & build tool)
+- Node.js (mature REPL with custom helpers)
 - ESLint + Prettier (linting & formatting)
 - Devshell commands via just
 
@@ -37,14 +38,29 @@ just dev
 fhs = true;
 ```
 
+## Available Commands
+
+Run `just` to see all available commands:
+
+```sh
+just dev       # Start dev server
+just repl      # Node.js REPL with helpers
+just lint      # Lint with ESLint
+just format    # Format with Prettier
+just build     # Production build
+just clean     # Clean build artifacts
+just update    # Update flake inputs
+just upgrade   # Upgrade bun packages
+```
+
 ## Customization
 
 This template provides minimal, sensible defaults. Customize as needed:
 
-- Add dependencies: `just add <package>`
 - Modify linting rules in `eslint.config.js`
 - Add Prettier config via `.prettierrc` if needed
 - Extend `Justfile` with project-specific commands
+- Add custom REPL helpers in `.replrc.js`
 
 ## Acknowledgments
 

nix/modules/devshell.nix

@@ -21,6 +21,7 @@ in {
       nativeBuildInputs = with pkgs;
         [
           bun
+          nodejs
           eslint
           just
           prettierd