File Explorer & Project Management

The File Explorer is where you spend most of your time organizing code. Gokino supports two flexible working modes: Cloud Mode and Local Mode.

1. Cloud Mode vs. Local Mode

At the top of the Explorer panel, you will see a Toggle Switch or tabs to switch modes:

☁️ Cloud Mode

  • Storage: Files are securely stored on Gokino's servers.
  • Pros: Accessible from anywhere, any device. Real-time synchronization.
  • Best for: New projects, sharing code, or when you don't want to install anything locally.

💻 Local Mode

  • Storage: Files reside directly on your computer's hard drive.
  • Mechanism: Uses the browser's File System Access API to read/write directly to your selected folder.
  • Pros: Absolute control over data, work offline (partially), use git tools or other editors in parallel.
  • How to use:
    1. Switch to Local mode.
    2. Click the Open Folder button.
    3. Select a project folder on your computer and grant access permission when prompted.

2. Working with Files & Folders

Creating New

  • New File: Click the File+ icon in the small toolbar above the file list.
    • Tip: Naming files ending in .ino for Arduino code, .h for headers, or .cpp for C++ source.
  • New Folder: Click the Folder+ icon to create subdirectories for organizing code.

Context Menu (Right-click)

Right-click on any file or folder to open the quick action menu:

  • Rename: Change name (Shortcut: F2).
  • Delete: Delete file/folder (Shortcut: Delete or Cmd/Ctrl + D). Note: This cannot be undone for Cloud files.
  • Download: Download file to your machine.

Drag & Drop

You can drag and drop files to move them between folders easily.

3. Other Tabs in Explorer

Besides the main file list tab, Explorer may contain other sub-tabs:

  • Sketches: A list of your other projects (sketches) (usually seen in Cloud mode).
  • Templates: Quick shortcuts to code templates (separated into its own module in newer versions).

Next: Library Management