
Appifio Creator · Lesson X13 · Troubleshooting
↔ Creator
Two writers editing the sandbox at once - files “jump,” Diff gets messy, live doesn’t match intent. Rule: one source of truth at a time; close one side before you open the other.
Goal: Avoid editing the same file in parallel; Diff → Save workflow; recover when it’s already messy (Clone/Checkpoint).
Before: T12, T01, X09 · After: (end of X series)
UI: Changes · Current · Compare changes / Diff · Save changes · Discard · Files · Versions · Clone
1. Conflict handling map
2. Glossary
| Concept | Meaning |
|---|---|
| MCP sandbox | IDE writes into the sandbox session - not live for visitors yet |
| Creator virtual disk | AI/Inspector also write drafts - same space as MCP after sync |
| Conflict | Both sides edited the same file - unclear which “last” version wins |
| Save changes | Publish the unpublished draft to the live site (T01/T12) |
Conflict ≈ two people Git-push without pull - Appifio does not smart-merge for you; you must Diff deliberately.
3. Daily prevention steps

- Pick a work shift: morning IDE (MCP), afternoon Creator - or the reverse; don’t interleave every minute.
- Before opening a Cursor agent: close Creator AI chat tabs or pause - avoid two writers.
- After MCP: open Creator → Changes badge → open Diff before prompting Creator AI further.
- Before Save changes: scan the Files tree - unexpected files / unwanted reverts.
- Suspect a bad overwrite: don’t Save - Clone or Discard with control (Clone first).
- Keep tokens/MCP only on trusted machines; rotate if leaked (X09).
4. Real conflict examples
- IDE edits the
index.htmlheader; Creator AI edits the footer in the same file → Diff shows two hunks - merge by hand or pick one side. - MCP adds a
routes.jsonentry; you forget the Routes tab Save → duplicate or missing route (T08). - Creator Discard while the IDE still thinks the sandbox is new - resume the MCP session (X09) then Diff again.
5. Issues · Advice
| Situation | Fix |
|---|---|
| File “jumps” between two versions | Stop one side · Diff · Clone as backup |
| IDE edits OK, visitors don’t see them | Haven’t clicked Save changes in Creator (T12) |
| Diff too large to review | Discard the draft · Clone · redo one MCP-only shift |
| Both sides editing login.json / shards | T04 - denied; reject that Diff immediately |
6. End-of-X checklist
- Can you handle X02 (preview), X04 (404), X08 (template wipe)?
- Do you avoid parallel MCP + Creator AI edits without Diff?
- Do you treat APK/MCP/domain limits as design, not “broken”?
- One shift = one source; close the IDE or pause Creator before switching?
X series complete (13/13)
T + K + X are covered. Full set: A-H how-to + T terms + K techniques + X troubleshooting.
Internal navigation (same language)
Appifio Creator · User guide · X13