Debugging and Troubleshooting

When to use this skill

• UI is not rendering as expected.
• Appwrite API calls are failing.
• Next.js build errors or hydration mismatches.

Protocol

1. Check Browser Console: Look for hydration errors or JavaScript crashes.
2. Check Network Tab: Inspect the request/response payload for Appwrite calls.
3. Check Appwrite Console: View "Logs" and "Permissions" for the failing collection.
4. Check Terminal: Look for use server or promise-related errors in the Next.js dev server.

Common Fixes

• Auth Error (401): User is not logged in or doesn't have permissions.
• Hydration Error: Ensure useState or browser-only APIs are wrapped in useEffect.
• Forbidden (403): Check Appwrite "Document Security" settings.

Instructions

• Log specifically: Use console.error('[Appwrite Error]:', error) for clarity.