Troubleshooting

Common mistakes and anti-patterns across Pyreon, grouped by area, each with its fix. Distilled from the framework's own anti-pattern catalog (372 entries) — the same source MCP get_anti_patterns serves to AI agents. Many are caught automatically by @pyreon/lint, pyreon doctor, or MCP validate; the detector code is noted on each entry that has one.

Categories

• Reactivity Mistakes — 32 entries

• JSX Mistakes — 25 entries

• Context & Provider Mistakes — 6 entries

• Architecture Mistakes — 73 entries

• Islands Mistakes — 11 entries

• SSR-rendering Mistakes — 23 entries

• SSG / e2e Test-Server Mistakes — 16 entries

• Bundling Mistakes — 4 entries

• Testing Mistakes — 24 entries

• Lifecycle & Cleanup Mistakes — 39 entries

• Build Pipeline Mistakes — 59 entries

• CI / Build Gate Mistakes — 23 entries

• Best-Practice Mistakes (opt-in @pyreon/lint rules) — 10 entries

• Library API-Shape Mistakes — 11 entries

• Documentation Mistakes — 16 entries