1.troubleshooting.md

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 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
2. Open a new issue with details
3. Join the Discord community for discussion