Documents
Welcome
Introducing
Why Misaki Studio
Compare
Start Here
Learn
Workflows
Export & Ship
AI & MCP
Questions & Answers
Reference
Troubleshooting
Examples

Troubleshooting

Start with the symptom you can observe. Record the project, file, app mode, exact message, action, and whether the failure affected project content or an external destination before retrying.

  • Problem area: Install, sign-in, profiles, projects, or invitations · Start here: Installation and login

  • Problem area: Agent cannot connect, select a project, or reach the app host · Start here: MCP connection

  • Problem area: Canvas, Preview, responsive, interaction, or rendering mismatch · Start here: Preview and rendering

  • Problem area: Generated code, dependencies, local export, Git, or consumer build · Start here: Export and build

  • Problem area: Incoming/outgoing changes, push, conflict, or history recovery · Start here: Synchronization

  • Problem area: API, Storage, Content, database, authentication, or access · Start here: Data and API

Before changing anything

  1. Save the exact error text or screenshot.

  2. Confirm the current project, file, target, Preview identity, and destination.

  3. Decide whether the failed action was a read, a project-content write, or an external side effect.

  4. Reread current state; do not assume a failed or warning result changed nothing.

  5. Make one correction and rerun the smallest reproduction.

If recovery could delete data, overwrite a destination, publish, push, or call a real write API, stop and inspect the specific recovery section first.

On this page
Troubleshooting
Before changing anything