Fix for webhook authorization failures caused by Base64 padding character (=) being dropped when copying secrets between systems. Use when: (1) Webhook returns "Unauthorized" or "Server Error" but the secret looks correct, (2) INTERNAL_API_SECRET, WEBHOOK_SECRET, or similar auth tokens fail validation between Railway/Vercel and Convex/database, (3) Secret comparison fails despite values appearing identical, (4) CLI tools display truncated environment variables. Common with Railway CLI, Vercel CLI, and other deployment platforms that may not display trailing = characters.
Search through Claude Code session memories and learned skills. Use when: (1) you need to find how a similar problem was solved before, (2) looking for relevant skills or knowledge, (3) checking if there's existing context about a project or technology, (4) the user asks "have we done this before?" or "what do you remember about X?". Triggers on: memory search, recall, remember, past sessions, history, previous work.
Understanding Convex + Better Auth dual-database architecture. Use when: (1) "User not found" errors during login/password reset but user appears to exist, (2) users exist in app's users table but can't authenticate, (3) need to create admin users in production, (4) debugging auth flows in Convex + Better Auth setup. Better Auth stores users in component tables separate from app tables.
Manage Better Auth user data in Convex component tables. Use when: (1) need to manually verify user email in development, (2) "Email not verified" error blocking login, (3) need to modify Better Auth user/session/account data directly, (4) can't write mutations to access component tables, (5) debugging auth issues in Convex + Better Auth setup. Covers CLI data access, export/import workflow, and common gotchas.
Fix for "Unauthorized" errors in Convex mutations called from Next.js API routes when using internal API secrets for authentication. Use when: (1) Convex mutation throws "Unauthorized" even though secret is set in .env.local, (2) webhook handlers fail with 500 status and "Unauthorized" in Convex function, (3) internal API calls work locally in Next.js but fail when calling Convex mutations. The fix is to set the secret in BOTH Next.js .env.local AND Convex environment variables.
Fix for expo-file-system migration errors when upgrading to Expo SDK 52+. Use when: (1) TypeScript error "Property 'cacheDirectory' does not exist on type", (2) "Module has no exported member 'EncodingType'" error, (3) "Property 'deleteAsync' does not exist" or similar FileSystem function errors, (4) file.info returns a function instead of file info object, (5) Upgrading Expo SDK and expo-file-system code breaks. Covers migration from legacy function-based API (FileSystem.deleteAsync, getInfoAsync) to new class-based API (File, Directory, Paths classes).
Fix for Ghost Admin API posts created with empty content when using HTML. Use when: (1) Ghost posts are created successfully but have no body content, (2) HTML field is sent in POST request but post appears empty, (3) title appears but html/body is blank, (4) implementing Ghost Admin API integration with HTML content. The fix is to use source=html as a QUERY PARAMETER, not in the JSON request body.
Fix for Next.js OG image build errors with invalid CSS display values. Use when: (1) Build fails with "Invalid value for CSS property display", (2) error mentions allowed values "flex" | "block" | "none" | "-webkit-box", (3) using display: inline-block or other CSS display values in next/og ImageResponse components. The fix is to use display: flex with alignSelf: flex-start instead of inline-block.