Skip to main content
    toolbar
    files
    source control
    git
    tutorial

    Left toolbar guide: Files & Source control

    November 18, 2025
    Makko Team
    3 min read

    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.