**Applies to:** Makko ▸ AI Studio

**Prerequisites:** An open project with file access (and a linked repo for Git features)

**Time to complete:** 3–6 minutes

## **Files (folder-stack icon)**

Browse, open, and manage your project files.

### **What you can do**

- **Browse folders**: Expand/collapse directories to locate assets and code.
- **Manually edit files**: Click a file (e.g., "index.html", "sprites-manifest.json") to view/edit its contents.
- **Search files**: Use the search bar to find files by name.
- **Preview supported files**: Images, JSON, and common text formats open inline.
- **Delete files:** Click the 3 dots on the right side of the file and select delete to delete files from your project.

### **Tips**

- Keep top-level tidy: "src/", "assets/", "scenes/", "manifests/" help the AI find things faster. Can use the Refactor Quick Action for the AI to assist in keeping file structures tidy.
- Use clear names ("MainScene.html", "rogue_manifest.json")—these are the names you'll reference in chat. AI will also interpret clear names more efficiently.

### **Troubleshooting**

- **I don't see my file.** Click refresh in the Files panel, or confirm you're in the correct project.

* * *

## **Source control (Git branch icon)**

Check repository status, fetch the latest code, manage branches, upload files, and browse your repo inside Makko.

### **What you can do**

- **Repository status:** See current branch and pending changes at a glance.
- **Download latest ZIP:** Get the repository's latest version as a ZIP archive.
- **Branch management:** Create, switch, and delete branches (based on your permissions).
- **Upload files to repo:** Add new files or replace existing ones.
- **Browse repository:** Navigate repo contents directly within Makko.

### **Typical workflows**

1. **Grab the newest code**  
   Open **Source control** ▸ **Download latest ZIP** ▸ extract locally if needed.  
2. **Switch branches**  
   Open **Source control** ▸ **Branches** ▸ **Switch** to "feature/your-change" (or create it).  
3. **Add/replace files**  
   Open **Source control** ▸ **Upload files** ▸ select files (e.g., updated sprites or HTML).

### **Tips**

- Name branches by purpose: "feature/player-combat", "fix/manifest-paths".
- Before switching branches, save edits in the Files panel to avoid losing in-progress changes.
- Keep binary assets (PNGs, audio) out of large commit churn, only upload what changed.

### **Troubleshooting**

- **Can't switch branches.** Resolve unsaved edits in Files, then try again; confirm you have branch permissions.
- **ZIP won't download.** Check network or repo access; retry after refreshing Source control.
- **Upload blocked or conflicts.** Another change may have landed—refresh repo view, rename your file, or retry on a new branch.

* * *

## **FAQ**

- **What's the difference between Files and Source control?**  
  _Files shows your working project in Makko. **Source control** interacts with the linked Git repository (branches, latest ZIP, uploads)._  
- **Do I need Git to build a game?**  
  _No, but Git helps with versioning, collaboration, and rollbacks._

## **Next steps**

- Use **🤖 Chat** to implement assets referenced by filename/manifest.
- See **"Add animations to your game (AI Studio)"** to wire sprites, states, and inputs.