Common Convex mistakes
Wrong function type, missing index, external calls in mutations.
Difficulty 2/5
Short
Plain English
Wrong function type, missing index, external calls in mutations. Picture it like this: Sending a forklift where a hand truck is needed. In the apps you ship (Agentify, wedding portals, CRM), you will bump into this on almost every screen — name it clearly when you prompt your coding agent.
Analogy
Sending a forklift where a hand truck is needed.
Go deeper
Wrong function type, missing index, external calls in mutations.
Common mistakes
- Letting the AI rename this concept three different ways in one PR.
- Building UI before you can say what is stored and who can change it.
AI-agent trap
Agents may invent jargon here. Ask them to explain the concept in plain English first, then map it to your schema and one real screen.
Summary
Wrong function type, missing index, external calls in mutations. Sending a forklift where a hand truck is needed. Ask yourself: where does this live in the database, which function changes it, and which screen shows it?
Confidence: