Troubleshooting¶

Common issues and their solutions when working with NextPresser.

Connection Issues¶

Cannot Connect to WordPress¶

Problem: NextPresser cannot connect to your WordPress GraphQL endpoint.

Solutions: 1. Verify NEXT_PUBLIC_WORDPRESS_URL is correct 2. Check that WPGraphQL plugin is installed and activated 3. Verify CORS settings in WordPress 4. Check network connectivity

GraphQL Endpoint Not Found¶

Problem: Getting 404 errors when accessing /graphql.

Solutions: 1. Ensure WPGraphQL plugin is activated 2. Check permalink settings in WordPress 3. Verify the endpoint URL in your configuration

Authentication Issues¶

JWT Token Expired¶

Problem: Authentication tokens are expiring too quickly.

Solutions: 1. Increase token expiration time 2. Implement token refresh logic 3. Check token generation settings

Performance Issues¶

Slow Page Loads¶

Problem: Pages are loading slowly.

Solutions: 1. Enable ISR (Incremental Static Regeneration) 2. Implement proper caching 3. Optimize GraphQL queries 4. Use image optimization

Build Errors¶

TypeScript Errors¶

Problem: TypeScript compilation errors.

Solutions: 1. Run npm run type-check 2. Update type definitions 3. Check for missing dependencies

Getting Help¶

If you're still experiencing issues:

• Check the GitHub Issues
• Join our Discord Community
• Review the FAQ