---
title: Troubleshooting
description: Common issues and how to resolve them
navigation:
  icon: i-lucide:wrench
---

Solutions to common issues when using npmx.dev.

## Package not found

If a package doesn't appear in search results or shows a 404 error:

1. **Check the package name** - Ensure the name is spelled correctly
2. **Verify it exists on npm** - Check [npmjs.com](https://www.npmjs.com/) directly
3. **Wait for sync** - Newly published packages may take a few minutes to appear

## Code viewer not loading

If the code viewer shows an error or doesn't load:

1. **Check package size** - Very large packages may take longer to load
2. **Try a specific version** - Use a versioned URL like `/package-name@1.0.0`
3. **Refresh the page** - Clear cache and reload

## Missing features compared to npmjs.com

Some features are not yet available:

| Feature                       | Status      |
| ----------------------------- | ----------- |
| Dependents list               | Coming soon |
| Package admin (access/owners) | Coming soon |
| Org/team management           | Coming soon |
| 2FA/account settings          | Not planned |

## Report an issue

If you encounter a bug or have a feature request:

1. Check [existing issues](https://github.com/npmx-dev/npmx.dev/issues)
2. [Open a new issue](https://issues.npmx.dev) with details
3. Join the [Discord community](https://chat.npmx.dev) for discussion