Merge remote-tracking branch 'refs/remotes/origin/master'

Author: oldrev

.github/FUNDING.yml

@@ -13,3 +13,4 @@ polar: # Replace with a single Polar username
 buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
 thanks_dev: # Replace with a single thanks.dev username
 custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
+  - https://paypal.me/oldrev

README.md

@@ -1,8 +1,12 @@
-# BorneoIoT: A State-of-the-Art Full-Stack Open-Source Aquarium LED WiFi Dimmer
+# BorneoIoT: Professional Aquarium Lighting Platform
 
 ![Firmware Build Status](https://github.com/borneo-iot/borneo/actions/workflows/fw-ci.yml/badge.svg)
 ![Firmware Release Status](https://github.com/borneo-iot/borneo/actions/workflows/fw-release.yml/badge.svg)
 ![App Build Status](https://github.com/borneo-iot/borneo/actions/workflows/flutter-ci.yml/badge.svg)
+[![Hardware: OSHWA Certified](https://img.shields.io/badge/Hardware-OSHWA%20CN000017-green)](https://certification.oshwa.org/cn000017.html)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue)](LICENSE)
+[![License: CERN-OHL-S-2.0](https://img.shields.io/badge/Hardware%20License-CERN--OHL--S--2.0-lightgrey)](LICENSE-HARDWARE)
+
 
 ![BorneoIoT Banner](assets/borneo-repo-banner.jpg)
 
@@ -11,75 +15,88 @@
         <a href="https://docs.borneoiot.com"><b>Documentation</b></a> •
         <a href="https://github.com/borneo-iot/borneo/discussions"><b>Forum</b></a> •
         <a href="https://discord.gg/EFJTm7PpEs"><b>Discord</b></a> •
-        <a href="https://flasher.borneoiot.com"><b>Web Firmware Flasher</b></a>
 </p>
 
 <p align="center">
     <a href="https://www.crowdsupply.com/borneo-iot/buce-aquarium-led-controller" target="_blank" rel="noopener">
         <img alt="Crowd Supply: Subscribe" src="https://img.shields.io/badge/Subscribe-Crowd%20Supply-009999?style=for-the-badge&logo=crowdsupply" />
     </a>
-</p>
-
+    <a href="https://flasher.borneoiot.com">
+        <img src="https://img.shields.io/badge/⚡%20Flash%20Firmware-Web%20Flasher-blue?style=for-the-badge" alt="Web Flasher">
+    </a>
 
----
+</p>
 
-**Borneo-IoT** is a professional-grade, modular open-source smart aquarium platform designed for aquarium enthusiasts and DIYers. It provides a complete end-to-end solution—from hardware schematics to embedded firmware and a modern mobile app—to build and control high-performance aquarium LED lighting systems.
 
-## One System, Three Pillars
+> **Production-grade open-source stack for aquarium LED dimmers.**
+> Hardware designs, embedded firmware, and mobile controls. Ready for weekend builds or product integration.
 
 This project delivers a full-stack solution for smart aquarium LED:
 
 1.  **Hardware**: Certified open-source PCB designs targeting the ESP32 family, featuring 6-channel PWM dimming and modular architecture.
 2.  **Firmware**: A robust ESP-IDF based firmware implementing CoAP/CBOR protocols, sunrise/sunset simulation, and cooling control.
 3.  **Mobile App**: A cross-platform Flutter application for intuitive real-time control, scheduling, and device management.
 
----
+## Quick Start
 
-## ️Key Features
+**New users:** Follow the **[step-by-step guide](https://docs.borneoiot.com/getting-started/quick-start.html)** to flash firmware and connect your first device.
 
-### Powerful Hardware
-- **OSHWA Certified**: Pro-grade designs (Model BLC06MK1) using [Horizon EDA](https://horizon-eda.org).
-  [![OSHWA Badge](assets/buce-oshwa.svg)](https://certification.oshwa.org/cn000017.html)
-- **High Performance**: Optimized for ESP32/ESP32-C3/C5 with unified board definitions.
-- **Precision Dimming**: 6-channel PWM with smooth 12-bit resolution and soft-start technology.
-- **Expandable**: Reference designs for LED lamps, drivers, and even dosing pumps.
+**No toolchain required**, flash directly from Chrome/Edge Browser:
 
-### Intelligent Firmware
-- **Dynamic Control**: Graphical sunrise/sunset curves with millisecond-smooth transitions.
-- **Reliable**: SNTP time synchronization and PID-controlled active cooling system.
-- **Production Ready**: Full support for over-the-air (OTA) updates and automated QA testing.[^1]
-- **Extensible Architecture**: Zephyr-inspired driver abstraction for easy porting and expansion.
+1. Connect ESP32/ESP32-C3/ESP32-C5 via USB
+2. Visit **[flasher.borneoiot.com](https://flasher.borneoiot.com)**
+3. Download the app and power on
 
-### Modern Control
-- **Cross-Platform**: Modern UI built with Flutter for iOS, Android, and beyond.
-- **Unified Protocol**: Uses CoAP + CBOR for efficient, low-latency device communication.
-- **Developer Friendly**: Includes a Python API client for custom automation scripts.
+[Full Getting Started Guide](https://docs.borneoiot.com/getting-started)
 
----
+## Features
 
-## Repository Structure
+### Hardware
 
-| Directory | Content | Description |
-| :--- | :--- | :--- |
-| [**`hw/`**](hw/) | **Hardware** | PCB designs (Horizon EDA), 3D models, and PDF schematics.[^2] |
-| [**`fw/`**](fw/) | **Firmware** | ESP-IDF source code for LED dimmers and upcoming devices. |
-| [**`client/`**](client/) | **Mobile App** | Flutter source code for the cross-platform mobile application. |
-| [**`borneopy/`**](borneopy/) | **Python SDK** | Python client library for desktop control and scripting. |
+- **6 or 10 PWM channels**, 12-bit resolution (4096 steps), up to 19kHz
+- **Flicker-free**, suitable for aquarium photography
+- **22×30mm core module**, fits slim LED fixtures
+- ESP32-C3/C5 native, WiFi + Bluetooth LE
 
----
+[Schematics & BoM](hw/)
+
+![Ulva-6](assets/ulva6.jpg)
+
+### Firmware
 
-[^1]: The open-source project does not provide mass production-related fixtures or specialized factory software.
-[^2]: PDF datasheets are provided; however, raw template source files for some documents are excluded.
+- **Sunrise/sunset curves** with millisecond-smooth transitions
+- **SNTP time sync**: automatic, no manual adjustment
+- **Active cooling control**: temperature-based fan/PWM throttling
+- **OTA updates**: over-the-air firmware upgrades
+- **CoAP + CBOR protocol**: efficient, low-latency device communication
+
+[Source code](fw/) • [Protocol docs](https://docs.borneoiot.com/protocol)
+
+### Mobile App
+
+- **Cross-platform**: iOS, Android, Windows, built with Flutter
+- **Real-time control**: dimming, scheduling, scene presets
+- **Multi-device**: group control, cloud-free local network
+- **Developer API**: Python client for automation
+
+[App source](client/) • [Python SDK](borneopy/)
+
+## Repository Guide
+
+| Directory | Contents | Entry Point |
+|-----------|----------|-------------|
+| [`hw/`](hw/) | PCB designs (Horizon EDA), Gerbers, 3D models | [`hw/README.md`](hw/) |
+| [`fw/`](fw/) | ESP-IDF firmware, CoAP protocol | [`fw/README.md`](fw/) |
+| [`client/`](client/) | Flutter mobile app | [`client/README.md`](client/) |
+| [`borneopy/`](borneopy/) | Python client library | [`borneopy/README.md`](borneopy/) |
 
 ## Getting Started
 
-- **New Users**: Check out our [**Getting Started Guide**](https://docs.borneoiot.com/getting-started).
+- **New Users**: Check out our [**Quick Start Guide**](https://docs.borneoiot.com/getting-started/quick-start.html).
 - If you are a new user looking to quickly experience our firmware, you can directly use our web firmware flasher to flash the latest version of the firmware to your ESP32 series development board: https://flasher.borneoiot.com/
 - **Hardware**: Find schematics and BoM files in the [`hw/`](hw/) directory.
 - **Firmware**: Compilation instructions are available in the [`fw/`](fw/) folder.
 
----
-
 ## Project Status
 
 | Component | Status | Details |
@@ -88,8 +105,6 @@ This project delivers a full-stack solution for smart aquarium LED:
 | **Firmware** | Beta | Full-featured and stable on my personal tanks for years. |
 | **Mobile App** | Beta | Core functionality working. |
 
----
-
 ## Roadmap
 
 Check our [milestones](https://github.com/borneo-iot/borneo/milestones) for the latest development updates and upcoming features.
@@ -102,8 +117,6 @@ Check our [milestones](https://github.com/borneo-iot/borneo/milestones) for the
 - **Discord**: [Connect with Developers](https://discord.gg/EFJTm7PpEs)
 - **Email**: [info@binarystarstech.com](mailto:info@binarystarstech.com)
 
----
-
 ## Licenses
 
 - **Software/Firmware**: Dual-licensed under [**GPL-3.0+**](LICENSE) and Enterprise licenses.

assets/ulva6.jpg

@@ -60,8 +60,13 @@ Borneo Client is a cross-platform Flutter application for controlling Borneo-IoT
 
 ### Localization
 
-- To handle localization: First, run the script `python .\scripts\update_translations.py .` to extract and update translation files.
-- Then, translate the `.po` files.
+- To manage translation assets, use the helper script under `scripts/bopo.py`.
+  - `python .\scripts\bopo.py update <project_path>` – generate/update the
+    `messages.pot` and all `.po` files based on Dart source strings.
+  - `python .\scripts\bopo.py missing <project_path>` – list any
+    untranslated entries (`msgstr` empty) across `.po` files along with path and line
+    number. This is useful for spotting work still to be done.
+- After running the update command, translate or review the `.po` files as needed.
 - During development tasks, do not modify `.po` files temporarily; translate them uniformly before release.
 
 Use the following patterns for localizing user-visible text with `flutter_gettext`: