Yoll IDE

Yoll IDE is an Electron-based desktop application for editing, running, and transferring Python and MicroPython code to development boards. This repository documents only the components that are present in the included source code.

Scope

• Code editing with Ace Editor.
• Local Python execution from the IDE.
• Port detection and basic board management.
• File transfer to MicroPython devices over serial.
• A library system for downloading compatible packages from external repositories.
• Local persistence for sessions and configuration.

Requirements

• Node.js 16 or later.
• Python 3.7 or later.
• System dependencies required by serialport and pyserial.

Installation

npm install

Development Run

npm start

Packaging

npm run build:win
npm run build:linux
npm run build:mac

Main Structure

src/
  main/        Electron main process and IPC
  renderer/    UI, editor, and frontend logic
  libraries/   Locally installed libraries
python/        Auxiliary and legacy utility scripts
docs/          Canonical technical documentation
resources/     Supporting resources

Documentation

• docs/README.md
• docs/MAIN_PROCESS.md
• docs/RENDERER_SYSTEM.md
• docs/BOARD_MANAGER.md
• docs/YOLL_UPLOADER.md
• docs/YOLL_LIBRARY_SYSTEM.md
• docs/LIBRARY_SYSTEM_GUIDE.md

Documentation Rules

• Documentation must describe behavior that is verifiable in the repository.
• Do not add commercial messaging, product promises, or references to unpublished components.
• Documentation for removed or proprietary modules should remain outside the public branch.

Security Note

Before publishing changes, review at least the following:

• embedded credentials or tokens;
• private URLs or internal infrastructure references;
• legacy documentation for undistributed components;
• temporary files or backups not meant for version control.