chore: add localias configuration for npmx.test

[vinnymac]

Configures localias so developers can utilize https://npmx.test locally, which also makes it easier to test on mobile devices without having to get fancy with tunnels or wired connections.

See CONTRIBUTING.md for "Custom Local Domain" usage instructions.

---

• includes a warning about AtProto redirect uris bringing you back to 127
• includes warnings for unsupported systems like windows with some recommendations, such as using WSL2
• native macOS / linux support of course
• configures nuxt to allow .test domains

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview, Comment	Feb 11, 2026 7:33pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored	Preview	Feb 11, 2026 7:33pm
npmx-lunaria	Ignored		Feb 11, 2026 7:33pm

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[coderabbitai]

📝 Walkthrough

Walkthrough

Adds local development domain support using Localias: adds .localias.yml mapping npmx.test to http://127.0.0.1:3000; new setup script scripts/setup-local-domain.sh to detect OS, ensure Localias is installed, configure capabilities, manage the daemon and create the alias; npm scripts setup:local and setup:local:uninstall; Vite allowedHosts: ['.test'] in nuxt.config.ts; .gitignore entries for local certs and .localias-certs/; CONTRIBUTING.md guidance for setup/uninstall; and knip.ts updated to ignore the localias binary.

Possibly related PRs

• chore: clean up deps & add comments to knip #849 — Modifies the same knip.ts KnipConfig export and comments; related to configuration changes in knip.ts.
• chore: knip config part 2: the resurgence #909 — Adjusts the knip.ts configuration object and project globs; overlaps with the ignoreBinaries addition.

Suggested reviewers

• danielroe

🚥 Pre-merge checks | ✅ 1

✅ Passed checks (1 passed)

Check name	Status	Explanation
Description check	✅ Passed	The pull request description clearly relates to the changeset, describing the addition of localias configuration for npmx.test local development across multiple files.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

No actionable comments were generated in the recent review. 🎉

🧹 Recent nitpick comments

scripts/setup-local-domain.sh (2)

64-65: Consider portability improvements for which and getcap.

• which is not POSIX-compliant and behaves inconsistently across systems; command -v is preferred.
• getcap may not be installed on minimal Linux distributions (requires libcap package).

♻️ Suggested improvement

-    LOCALIAS_PATH=$(which localias)
-    if ! getcap "$LOCALIAS_PATH" 2>/dev/null | grep -q "cap_net_bind_service"; then
+    LOCALIAS_PATH=$(command -v localias)
+    if ! command -v getcap &>/dev/null; then
+        echo -e "${Y}⚠ getcap not found, skipping capability check${NC}"
+        echo "Install libcap (e.g., apt install libcap2-bin) for automatic capability management"
+    elif ! getcap "$LOCALIAS_PATH" 2>/dev/null | grep -q "cap_net_bind_service"; then

---

84-84: Add -r flag to read to prevent backslash interpretation.

Although unlikely to cause issues here (user is just pressing Enter), using read -r is a shell best practice to prevent backslash escape interpretation.

♻️ Suggested fix

-    read -p "Press Enter to continue or Ctrl+C to cancel... "
+    read -rp "Press Enter to continue or Ctrl+C to cancel... "

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 3