chore: default --host from 127.0.0.1 to localhost (#22)

Browsers treat 127.0.0.1 and localhost as separate origins for
storage, but for first-run UX localhost is the friendlier and more
familiar default — matches Vite, Next.js dev, etc. — and WebAuthn
(passkeys) explicitly requires the Relying Party ID to be 'localhost'
or a real domain, so this also unlocks the eventual rung-3 climb.

Server-side reachability is unchanged: Node's localhost bind covers
both 127.0.0.1 and ::1 loopback. Existing users with browser data
keyed to the old 127.0.0.1 origin will need to sign in again
(IndexedDB is per-origin).

- options.host default: '127.0.0.1' → 'localhost'
- Banner / auto-open URL / IDP issuer follow automatically via formatUrl
- Help text + README + inline LAN-warning copy updated
- Loopback-check still accepts both names (no behaviour change there)

Bumps jspod to 0.0.24.

Author: melvincarvalho

README.md

@@ -19,13 +19,13 @@ Your browser opens to `http://localhost:5444`. Click **Sign in** and use:
 
 That's it. You have a working Solid pod with a passkey-capable identity provider, a tiny built-in data browser, and a [WebID](https://www.w3.org/2005/Incubator/webid/spec) you can point any Solid app at.
 
-> jspod binds to `127.0.0.1` by default so the placeholder `me` / `me` credentials are reachable only from your local machine.
+> jspod binds to `localhost` by default so the placeholder `me` / `me` credentials are reachable only from your local machine.
 
 ## CLI options
 
 ```
   -p, --port <number>     Port to listen on (default: 5444)
-  -h, --host <address>    Host to bind to (default: 127.0.0.1)
+  -h, --host <address>    Host to bind to (default: localhost)
   -r, --root <path>       Data directory (default: ./pod-data)
       --multiuser         Enable multi-user mode (registration enabled)
       --no-auth           Open pod, no IDP, no ACL (demos / dev only)

index.js

@@ -37,7 +37,7 @@ function formatUrl(host, port) {
 const args = process.argv.slice(2);
 const options = {
   port: 5444,
-  host: '127.0.0.1',
+  host: 'localhost',
   root: './pod-data',
   multiuser: false,
   auth: true,
@@ -47,7 +47,7 @@ const options = {
 // Auth-ladder rung-1 credentials. See issue #6: jspod ships a deliberately
 // weak default sign-in so the new user is on a working pod within seconds,
 // with a clearly-marked path to climb (change password / add a passkey).
-// Safe because the default host is localhost-only (127.0.0.1).
+// Safe because the default host is localhost-only.
 // Username is fixed by JSS for root pods (server.js:970). Password defaults
 // to 'me' but can be overridden via JSS_SINGLE_USER_PASSWORD so the env
 // override documented in the README actually takes effect (and the banner
@@ -129,7 +129,7 @@ for (let i = 0; i < args.length; i++) {
     console.log(chalk.yellow('  jspod') + chalk.dim(' [options]\n'));
     console.log(chalk.white('Options:'));
     console.log(chalk.green('  -p, --port ') + chalk.yellow('<number>') + chalk.dim('     Port to listen on (default: 5444)'));
-    console.log(chalk.green('  -h, --host ') + chalk.yellow('<address>') + chalk.dim('    Host to bind to (default: 127.0.0.1)'));
+    console.log(chalk.green('  -h, --host ') + chalk.yellow('<address>') + chalk.dim('    Host to bind to (default: localhost)'));
     console.log(chalk.green('  -r, --root ') + chalk.yellow('<path>') + chalk.dim('       Data directory (default: ./pod-data)'));
     console.log(chalk.green('  --multiuser') + chalk.dim('            Enable multi-user mode'));
     console.log(chalk.green('  --no-auth') + chalk.dim('              Disable authentication'));
@@ -316,7 +316,7 @@ if (options.auth && !options.multiuser) {
       console.log('\n' + chalk.bold.red('⚠  Warning: ') + chalk.yellow(
         `--host ${options.host} exposes the well-known me/me credentials beyond localhost.`
       ));
-      console.log(chalk.dim('   Set JSS_SINGLE_USER_PASSWORD=... before running, or bind to 127.0.0.1.'));
+      console.log(chalk.dim('   Set JSS_SINGLE_USER_PASSWORD=... before running, or bind to localhost.'));
     }
   }
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "jspod",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "description": "JavaScript Solid Pod - Just works, batteries included",
   "type": "module",
   "main": "index.js",