Update README.md

Author: cifertech

README.md

@@ -20,11 +20,44 @@
 
 <br />
 
-# 🎨 DisplayKit  
+# 🎨 DisplayKit
 
-**DisplayKit** is a modern web-based drag-and-drop UI designer for embedded display development.  
-Design screens visually → export clean Arduino code → flash to ESP32, ESP8266, STM32, Arduino, RP2040, and more.
+**DisplayKit** is a modern web-based drag-and-drop UI designer for embedded display development.
 
+Design screens visually → generate clean **Arduino** drawing code → run it on boards like **ESP32 / ESP8266 / STM32 / Arduino / RP2040** (and more).
+
+## Quick start (recommended)
+
+- **Use it online (recommended)**: click the GitHub Pages link in the repository, or open: `https://cifertech.github.io/DisplayKit/`
+
+
+## How to use
+
+- **Pick display driver**: choose **TFT_eSPI** or **U8g2 OLED** from the sidebar (and set your display resolution)
+- **Create screens**: add as many as you like and name the generated function (e.g. `drawHomeScreen`)
+- **Add elements**: click an element type to add it, then drag / resize and edit properties
+- **Export**:
+  - **Copy** the generated code from “Generated Code (TFT_eSPI / U8g2)”
+  - **Export JSON** to save a project snapshot (great for versioning)
+  - **Import JSON** to restore a saved project
+
+## Built-in tools
+
+DisplayKit includes tool pages under `tools/` and can open them inside the app overlay:
+
+- **PixelForge** (`tools/pixelforge/`): image converter (generate RGB565 headers and import into DisplayKit)
+- **BitCanvas Studio** (`tools/bitcanvas-studio/`): animation tool (export and copy to clipboard)
+- **Shared tool theming**: `tools/theme.css` keeps tool pages visually consistent with DisplayKit
+
+## Keyboard shortcuts
+
+- **Undo / Redo**: `Ctrl/Cmd + Z` / `Ctrl/Cmd + Shift + Z`
+- **Duplicate**: `Ctrl/Cmd + D`
+- **Cycle selection**: `Tab` / `Shift + Tab`
+- **Align selected**: `Ctrl/Cmd + 1..6` (left / center / right / top / middle / bottom)
+- **Move selected**: Arrow keys (hold **Shift** for bigger steps)
+- **Delete selected**: `Delete` / `Backspace`
+- **Close Tools overlay**: `Esc`
 
 ## 🚀 Features
 
@@ -89,6 +122,23 @@ Design screens visually → export clean Arduino code → flash to ESP32, ESP826
 | **U8g2**        | ✅ Full | Monochrome + full font system |
 | **Adafruit_GFX** | ⚠ Planned | Not implemented yet |
 
+## Project structure
+
+```text
+.
+├─ index.html        # Main app UI
+├─ style.css         # Main app styling
+├─ app.js            # App logic (editor + code generation)
+└─ tools/
+   ├─ pixelforge/       # Image converter tool
+   ├─ bitcanvas-studio/ # Animation tool
+   └─ theme.css         # Shared theme tokens for tool pages
+```
+
+## License
+
+See `LICENSE`.
+
 &nbsp;
 
 ## 🤝 Contribute