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)
docs.npmx.dev	Ready	Preview, Comment	Feb 13, 2026 2:40pm
npmx.dev	Ready	Preview, Comment	Feb 13, 2026 2:40pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
npmx-lunaria	Ignored		Feb 13, 2026 2:40pm

[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 Localias-based local development domain support: new .localias.yml mapping npmx.test to http://127.0.0.1:3000; new scripts/setup-local-domain.sh to detect OS, verify/install Localias, 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 instructions for optional local-domain setup; 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 | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description check	✅ Passed	The pull request description clearly explains the changes: configuring localias for npmx.test local development, including platform support details and AtProto OAuth considerations.
Merge Conflict Detection	✅ Passed	✅ No merge conflicts detected when merging into main

_{✏️ 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. 🎉

---

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

[coderabbitai]

Actionable comments posted: 3

[ghostdevv]

In lieu of any decision on this, personally I think this would make more sense in the documentation if you're interested in opening a PR for that? I will close this one for now though, but if other people want to upvote this or overrule me we can reopen!

[vinnymac]

If I recall from Discord we wanted to explore if portless is ready as a replacement over localias. I haven’t tried it yet though, in any case I agree closing for now makes the most sense.