Skip to content
Mistflow

Troubleshooting

Mistflow not showing up in my editor

Section titled “Mistflow not showing up in my editor”

Your editor can’t see Mistflow.

  1. Check that the MCP config file exists and has the mistflow entry:

    • Claude Code: ~/.claude.json
    • Cursor: ~/.cursor/mcp.json

  2. Restart your editor completely (not just reload).

  3. If the issue persists, re-run the installer:

    Terminal window
    npx -y mistflow-ai install

“Authentication failed”

Section titled ““Authentication failed””

Your credentials are missing or expired.

Tell your AI: Log me in to Mistflow — this re-runs the device code auth flow and refreshes your credentials.

Build fails during deploy

Section titled “Build fails during deploy”

Mistflow runs a build check before deploying. If it fails:

  1. Ask your AI: Debug the build errors — it will parse the errors and suggest fixes.
  2. Fix the issues and ask to deploy again.

Deploy succeeds but the site shows a blank page

Section titled “Deploy succeeds but the site shows a blank page”

This usually means:

  • The index.html is missing from the build output
  • JavaScript has a runtime error

Ask your AI: Debug why my deployed site shows a blank page — it will check the build output and logs.

Custom domain not working

Section titled “Custom domain not working”

DNS propagation can take up to 48 hours (usually 1-10 minutes).

  1. Check your DNS records match what the dashboard shows
  2. Click Verify in the dashboard to re-check
  3. Make sure you don’t have conflicting A/AAAA records for the same domain

”Deploy limit reached”

Section titled “”Deploy limit reached””

You’ve hit your plan’s monthly deploy limit. Options:

  • Wait until the next billing cycle
  • Upgrade your plan from Settings

Something else?

Section titled “Something else?”