forked from
npmx.dev/npmx.dev
[READ-ONLY]
a fast, modern browser for the npm registry
1---
2title: Troubleshooting
3description: Common issues and how to resolve them
4navigation:
5 icon: i-lucide:wrench
6---
7
8Solutions to common issues when using npmx.dev.
9
10## Package not found
11
12If a package doesn't appear in search results or shows a 404 error:
13
141. **Check the package name** - Ensure the name is spelled correctly
152. **Verify it exists on npm** - Check [npmjs.com](https://www.npmjs.com/) directly
163. **Wait for sync** - Newly published packages may take a few minutes to appear
17
18## Code viewer not loading
19
20If the code viewer shows an error or doesn't load:
21
221. **Check package size** - Very large packages may take longer to load
232. **Try a specific version** - Use a versioned URL like `/package-name@1.0.0`
243. **Refresh the page** - Clear cache and reload
25
26## Missing features compared to npmjs.com
27
28Some features are not yet available:
29
30| Feature | Status |
31| ----------------------------- | ----------- |
32| Dependents list | Coming soon |
33| Package admin (access/owners) | Coming soon |
34| Org/team management | Coming soon |
35| 2FA/account settings | Not planned |
36
37## Report an issue
38
39If you encounter a bug or have a feature request:
40
411. Check [existing issues](https://github.com/npmx-dev/npmx.dev/issues)
422. [Open a new issue](https://issues.npmx.dev) with details
433. Join the [Discord community](https://chat.npmx.dev) for discussion