logo

Troubleshooting

Solutions for common issues with Create RX App

Installation Issues

Permission Errors

If you encounter permission errors when installing globally:

Error: EACCES: permission denied

Solution:

  • Use npx instead of global installation
  • Fix npm permissions as described in the npm documentation

Version Compatibility

If you see errors related to Node.js version:

Error: Create RX App requires Node.js 16.14.0 or later.

Solution:

  • Update Node.js to version 16.14.0 or later
  • Use a version manager like nvm to switch Node.js versions

Project Creation Issues

Directory Already Exists

If you see an error about the directory already existing:

Error: Directory my-app already exists and is not empty

Solution:

  • Choose a different project name
  • Remove or rename the existing directory

Network Issues

If you encounter network errors during dependency installation:

npm ERR! network timeout

Solution:

  • Check your internet connection
  • Try using a different npm registry
  • Increase the network timeout: npm config set fetch-timeout 300000

Runtime Issues

tRPC Connection Errors

If you see errors related to tRPC connection:

TRPCClientError: Failed to fetch

Solution:

  • Make sure your server is running
  • Check that the tRPC endpoint URL is correct in your client configuration
  • Verify that your API routes are properly set up

TypeScript Errors

If you encounter TypeScript errors:

TS2307: Cannot find module '@/components/ui/button' or its corresponding type declarations.

Solution:

  • Make sure all dependencies are installed
  • Check your tsconfig.json paths configuration
  • Restart your TypeScript server in your editor

shadcn/ui Issues

If you have issues with shadcn/ui components:

Error: Cannot find module '@radix-ui/react-slot'

Solution:

  • Install the missing dependency: npm install @radix-ui/react-slot
  • Make sure you've followed the shadcn/ui setup correctly

Getting Help

If you're still experiencing issues, you can: