Update readme

Author: murilopolese

README.md

@@ -1,26 +1,31 @@
 # Arduino Lab for MicroPython
 
-Arduino Lab for MicroPython is a lightweight editor for MicroPython programs, supporting connection with a board, code upload, file transfer, interactive REPL shell.
-This project is sponsored by Arduino, based on original work by Murilo Polese. This is an experimental pre-release software, please direct any questions only to Github issues.
+Arduino Lab for MicroPython is a lightweight editor for MicroPython programs, supporting connection with a board, code upload, file transfer and interactive REPL shell.
+This project is sponsored by Arduino, based on original work by [Murilo Polese](http://www.murilopolese.com). This is an experimental pre-release software, please direct any questions only to Github issues.
 
 ## Features
 - MicroPython's Read Eval Print Loop (REPL)
 	- Enter paste mode
 	- Enter raw repl
 	- Software reset
+	- Tab to autocomplete
 - File system management (Disk and MicroPython File System)
 	- Create
 	- Rename
+	- Multiple file and folder selection
 	- Remove
 	- Upload
 	- Download
-- Text editor with Python syntax highlight
-- Code execution controls
+- Text editor
+	- Python syntax highlight and autocomplete
+	- Multiple tabs
+	- Rename tabs
+- Code execution
 	- Run what's on text editor
 	- Stop (keyboard interrupt)
 	- Soft reset
 
-## Technical
+## Technical overview
 
 Arduino Lab for MicroPython is an [Electron](https://www.electronjs.org/) app that has its main purpose to communicate over serial with a microprocessor running [MicroPython](https://micropython.org/). All Electron code is at `/index.js`.
 
@@ -36,33 +41,21 @@ At the root of the repository you will find:
 
 - `/.github`: Github's workflow configuration.
 - `/build_resources`: Icons and other assets used during the build process.
-- `/scripts`: Scripts executed during the build process.
 - `/ui`: Available user interfaces.
 - `/index.js`: Main Electron code.
-- `/preload.js`: Creates Disk and Serial APIs on Electron's main process and exposes it to Electron's renderer process (context bridge).
+- `/preload.js`: Creates Disk, Serial and Window APIs on Electron's main process and exposes it to Electron's renderer process (context bridge).
 
-## Arduino UI
+## User interface
 
-Default UI is a [choo-choo](https://github.com/choojs/choo) app. It has pre-built dependencies so no build process is required for the interface.
-
-The dependencies and source code are included manually in the `/ui/arduino/index.html` file.
-
-The app is a standard [choo-choo](https://github.com/choojs/choo) app and it has:
-
-- `/ui/arduino/app.js`: A router deciding which view to load.
-- `/ui/arduino/components`: HTML templates and components.
-- `/ui/arduino/store.js`: A "store" that handles events emitted by the views, change the app state and orchestrate re-rendering.
-- `/ui/arduino/libs`: Prebuilt dependencies.
-
-It can be useful to learn more about [Choo](https://github.com/choojs/choo) or the [Elm Architecture](https://guide.elm-lang.org/architecture/).
+Read more at [`/ui/arduino/README.md`](./ui/arduino/README.md)
 
 ## Disk and Serial API
 
 In order for the UI code to be independent of Electron code, there is an API defined at `/preload.js` that describes all the allowed operations.
 
-There are 2 main operation "channels": Serial communication and local Filesystem operations. Both channels offer methods that always return promises and are used mostly through [`async`/`await`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function).
+There are 3 main operation "channels": Serial communication, local filesystem and window operations. These channels offer methods that should always return promises and are used mostly through [`async`/`await`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function).
 
-While the serial communication is mediated by `/micropython.js`, the local filesystem operations are done through Electron's `ipcRenderer` calls. The handlers for these calls are defined at `/index.js`
+While the serial communication is mediated by `/micropython.js`, the local filesystem and window operations are done through Electron's `ipcRenderer` calls. The handlers for these calls are defined at `/index.js`
 
 ## Running Arduino Lab for MicroPython from source code
 
@@ -73,7 +66,6 @@ While the serial communication is mediated by `/micropython.js`, the local files
 
 Some changes on the Electron code will require reopening the app but all UI changes will only require refreshing the window (ctrl-r/cmd-r).
 
-
 ## Trademarks
 
 "Python" and the Python Logo are trademarks of the Python Software Foundation.

ui/arduino/README.md

@@ -0,0 +1,23 @@
+# Arduino Lab for MicroPython Editor
+
+![Arduino Lab for MicroPython Editor interface](./documents/Screenshot from 2024-04-15 09-48-25.png)
+![Arduino Lab for MicroPython Editor interface](./documents/Screenshot from 2024-04-15 09-47-03.png)
+
+This UI is a [choo-choo](https://github.com/choojs/choo) app. It has pre-built dependencies so *no build process* is required for the interface.
+
+The dependencies and source code are included manually in the `/ui/arduino/index.html` file. *No installation process* is required for the UI.
+
+The is a standard [choo-choo](https://github.com/choojs/choo) app. It can be useful to learn more about [Choo](https://github.com/choojs/choo) or the [Elm Architecture](https://guide.elm-lang.org/architecture/).
+
+In this folder you will find:
+
+- `/ui/arduino/main.js`: A router deciding which view to load.
+- `/ui/arduino/store.js`: A "store" that handles events emitted by the views, change the app state and orchestrate re-rendering.
+- `/ui/arduino/libs`: Prebuilt dependencies.
+- `/ui/arduino/views`: HTML views, components and elements.
+  - Views: Page size layouts
+  - Components: Independent sections that assemble the page layout
+  - Elements: Thin abstraction on top of HTML tags.
+- `/ui/arduino/media`: Icons and image assets.
+- `/ui/arduino/documents`: System model and layout.
+- `/ui/arduino/helpers.py`: MicroPython functions that enable some of the UI features.