@mxtommy/kip 3.11.0 → 3.12.0

package/CHANGELOG.md

@@ -1,8 +1,22 @@
+# v 3.12.0
+# New Features
+* Chartplotter Mode: A dual‑panel, performance‑tuned split experience that lets you run KIP dashboards and Freeboard‑SK together in one adaptive shell. Keep the chart live while moving between dashboards. Seamless side‑by‑side in landscape, smart vertical stacking in portrait and as always, designed for mobile and touch. Use the per‑dashboard forced collapse option for data‑focused layouts while Freeboard remains active in the background. Drag resize split distribution with commit‑on‑save editing. This feature brings you:
+  * Freeboard-SK chart continuity while you cycle dashboards (full-on dedicated MFD feel, Signal K native!)
+  * Remote dashboard switching compatible (no chart context loss)
+  * Split collapse and change dashboard transitive animations
+  * Per‑dashboard collapse flag to lock map closed for data‑dense layouts
+  * Optional Freeboard‑SK widget still available if persistent background map not required
+# Improvements
+* Updated help documentation:
+  * New Community section: curated video library, creator channel directory, contribution guidelines (PR / Discord #showcase) and ecosystem resource table.
+  * Added optional Chromium "No Sleep" and resource usage optimization launch parameters to the "Kiosk Mode" documentation.
+  * Enhanced "Digital Switching and PUT" section with links to supported devices.
+  * "Managing Dashboards" tips and recommendations update.
 # v 3.11.0
-# New Feature
+# New Features
 * Level gauge: Dual-scale heel angle indicator combining a high‑precision ±5° fine level with a wide ±40° coarse arc for fast trim tuning and broader heel / sea‑state monitoring. **Special thanks to @fymmot for permission to integrate his plugin code. See https://github.com/fymmot/signalk-heel-angle**
 # Improvements
-* Minor Switch Panel state visibility improvement using bold fonts and a blow effect. Fixes #813
+* Minor Switch Panel state visibility improvement using bold fonts and a glow effect. Fixes #813
 * Enhance Countdown Timer Widget with Configurable Time and Sound Alerts. Fixes #814
 ## Fixes
 * Dashboard edit button in disabled state on initial app load. Fixes #809

package/README.md

@@ -1,4 +1,7 @@
 # KIP – Signal K Multi-Function Display (MFD) and Marine Instrument Panel
+[![Help Docs](https://img.shields.io/badge/Help-Docs-blue)](src/assets/help-docs/welcome.md)
+[![Community Videos](https://img.shields.io/badge/Community-Videos-purple)](src/assets/help-docs/community.md)
+[![Contact](https://img.shields.io/badge/Contact-Get_in_touch-success)](src/assets/help-docs/contact-us.md)
 
 **KIP is the most popular Signal K MFD and marine instrument panel: plug-and-play, touch-optimized, pre-installed, and ready-to-use across all devices.**
 
@@ -64,18 +67,15 @@ Run KIP in full-screen mode without browser controls, just like a native mobile
 - Effortlessly create and customize dashboards using an intuitive grid layout system.
 - Add, resize, and align widgets to design tailored displays for your specific needs.
 - Duplicate widgets or entire dashboards, including their configurations, with a single click.
-- Organize and reorder dashboards by adding names and arranging them to suit your workflow.
-- Seamlessly switch between multiple dashboards for different roles, devices, or use cases.
-
-### Multiple User Profiles
-Create and manage profiles for different roles, devices, or use cases. Each profile can have its own dashboard configurations and settings.
+- Simply drag dashboards to reorganize them. Double-click any dashboard to open the icon gallery and give each page a unique visual identity.
+- Seamlessly switch between multiple configuration profles for different roles and devices or use cases.
 
 ## User Experience
 
 ### Flexible and Easy
 Meant to build purposeful dashboards with however many widgets you want, wherever you want them.
 
-Add, resize, and position the widgets of your choosing. Need more? Add as many additional dashboards as you wish to keep your display purposeful. Simply swipe up and down to quickly cycle through dashboards.
+Add, resize, and position the widgets of your choosing. Need more? Add as many additional dashboards as you wish to keep your display purposeful. Simply swipe up and down to quickly cycle through dashboards or effortlessly jump between dashboards with a single tap in the action sidenav, always knowing exactly where you are thanks to clear highlighting of your current dashboard.
 
 Add widget lists sorted by category
 ![Layouts Configuration Image](./images/KipWidgetConfig-layout-1024.png)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxtommy/kip",
-  "version": "3.11.0",
+  "version": "3.12.0",
   "description": "An advanced and versatile marine instrumentation package to display Signal K data.",
   "license": "MIT",
   "author": {

package/public/3rdpartylicenses.txt

@@ -1,30 +1,4 @@
 
---------------------------------------------------------------------------------
-Package: @godind/canvas-gauges
-License: "MIT"
-
-The MIT License (MIT)
-
-Copyright (c) 2016 Mykhailo Stadnyk <mikhus@gmail.com>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
 --------------------------------------------------------------------------------
 Package: howler
 License: "MIT"
@@ -50,12 +24,12 @@ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 --------------------------------------------------------------------------------
-Package: gridstack
+Package: @angular/material
 License: "MIT"
 
-MIT License
+The MIT License
 
-Copyright (c) 2019-2023 Alain Dumesny. v0.4.0 and older (c) 2014-2018 Pavel Reznikov, Dylan Weiss
+Copyright (c) 2025 Google LLC.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -64,16 +38,16 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 Package: @angular/animations
@@ -102,10 +76,12 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 
 --------------------------------------------------------------------------------
-Package: ngx-resize-observer
+Package: @angular/platform-browser
 License: "MIT"
 
-Copyright (c) 2017 Tyler Akins
+The MIT License
+
+Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -114,24 +90,24 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
 
 --------------------------------------------------------------------------------
-Package: @angular/material
+Package: @godind/canvas-gauges
 License: "MIT"
 
-The MIT License
+The MIT License (MIT)
 
-Copyright (c) 2025 Google LLC.
+Copyright (c) 2016 Mykhailo Stadnyk <mikhus@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -148,30 +124,40 @@ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
 --------------------------------------------------------------------------------
-Package: chartjs-plugin-annotation
+Package: gridstack
 License: "MIT"
 
-The MIT License (MIT)
+MIT License
 
-Copyright (c) 2016-2021 chartjs-plugin-annotation Contributors
+Copyright (c) 2019-2023 Alain Dumesny. v0.4.0 and older (c) 2014-2018 Pavel Reznikov, Dylan Weiss
 
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
 --------------------------------------------------------------------------------
-Package: @godind/ng-canvas-gauges
+Package: ngx-resize-observer
 License: "MIT"
 
-MIT License
-
-Copyright (c) 2017 Vlad Martynenko <vladimir.martynenko.work@gmail.com>
+Copyright (c) 2017 Tyler Akins
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -192,12 +178,26 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 --------------------------------------------------------------------------------
-Package: @angular/platform-browser
+Package: chartjs-plugin-annotation
 License: "MIT"
 
-The MIT License
+The MIT License (MIT)
 
-Copyright (c) 2010-2025 Google LLC. https://angular.dev/license
+Copyright (c) 2016-2021 chartjs-plugin-annotation Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+Package: @godind/ng-canvas-gauges
+License: "MIT"
+
+MIT License
+
+Copyright (c) 2017 Vlad Martynenko <vladimir.martynenko.work@gmail.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -206,16 +206,16 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
 --------------------------------------------------------------------------------
 Package: @angular/cdk

package/public/assets/help-docs/community.md

@@ -0,0 +1,78 @@
+# Online Community Content
+
+> Want to contribute a video or resource? Share your links by [submitting a PR to this page](https://github.com/mxtommy/Kip/blob/master/src/assets/help-docs/community.md), use the [KIP Discord channel](https://discord.gg/AMDYT2DQga) or open a [GitHub issue](https://github.com/mxtommy/Kip/issues)**!
+
+Explore KIP in action and learn from the community. Below are curated videos, creator channels, and related ecosystem resources.
+
+## Community Video Library
+Curated videos created by community members. Ordered to highlight broad onboarding value first.
+
+| Thumbnail | Video | Focus | Author / Channel |
+|-----------|-------|-------|------------------|
+| ![KIP v3 Overview](https://i.ytimg.com/vi/53s4JsivXjU/hqdefault.jpg) | [KIP v3 – New Features, Setup & Configuration Walkthrough (Full Overview)](https://www.youtube.com/watch?v=53s4JsivXjU) | Full platform overview & configuration | Boating with the Baileys |
+| ![Raspberry Pi Dashboard Review](https://i.ytimg.com/vi/vDWr8qbK55s/hqdefault.jpg) | [Full review raspberry PI dashboard for sailboats. SV GOAT teach](https://www.youtube.com/watch?v=vDWr8qbK55s) | Hardware + dashboard review (Raspberry Pi) | sailing sv goat |
+| ![Open Source Boat Build Part IV](https://i.ytimg.com/vi/BOPwfBOE1DE/hqdefault.jpg) | [Building an Open Source Boat with Raspberry Pi & NMEA 2000 - Part IV - OpenPlotter, Signal K, KIP](https://www.youtube.com/watch?v=BOPwfBOE1DE) | Integration & onboard system build | The Florida Captain |
+| ![SignalK Racer Widgets](https://i.ytimg.com/vi/oFX2F0z5xqU/hqdefault.jpg) | [SignalK racer plugin KIP widgets – July 2025](https://www.youtube.com/watch?v=oFX2F0z5xqU) | Racing plugin KIP widgets demo | Gregory J Wilkins |
+| ![Charla Nautica Friki](https://i.ytimg.com/vi/3pnVsj44VO4/hqdefault.jpg) | [I Charla Náutica Friki: Raspberry, Domótica, Signal K, Interconexión de Equipos…](https://www.youtube.com/watch?v=3pnVsj44VO4) | Spanish session: ecosystem & integration | Luisloflipa Sailing |
+
+Improve or add entries: PR or Discord #showcase.
+
+---
+
+## Authors & Channels
+Creator channels producing helpful KIP or Signal K related content.
+
+### Boating with the Baileys
+- Channel: https://www.youtube.com/@BoatingwiththeBaileys
+- Focus: End‑user onboarding, feature walkthroughs, configuration best practices.
+- Featured Video: [KIP v3 – New Features, Setup & Configuration Walkthrough](https://www.youtube.com/watch?v=53s4JsivXjU)
+
+### Sailing sv goat
+- Channel: https://www.youtube.com/@sv_goat
+- Focus: Practical onboard installs, Raspberry Pi builds, real‑world usage.
+- Featured Video: [Full review Raspberry Pi dashboard for sailboats](https://www.youtube.com/watch?v=vDWr8qbK55s)
+
+### The Florida Captain
+- Channel: https://www.youtube.com/@TheFloridaCaptain
+- Focus: Open source boat build series, NMEA 2000 integration, system architecture.
+- Featured Video: [Open Source Boat Build Part IV](https://www.youtube.com/watch?v=BOPwfBOE1DE)
+
+### Gregory J Wilkins
+- Channel: https://www.youtube.com/@gregoryjwilkins6001
+- Focus: Racing plugin experimentation, tactical visualization, performance tooling.
+- Featured Video: [SignalK Racer Plugin KIP Widgets](https://www.youtube.com/watch?v=oFX2F0z5xqU)
+
+### Luisloflipa Sailing
+- Channel: https://www.youtube.com/@luisloflipa
+- Focus: Spanish-language coverage, integration discussions, DIY marine electronics.
+- Featured Video: [Charla Náutica Friki](https://www.youtube.com/watch?v=3pnVsj44VO4)
+
+### Want to Be Listed?
+Open a PR or post in Discord #showcase with:
+- Channel name + link
+- Focus summary (1 line)
+- One featured video (link + short purpose sentence)
+
+---
+
+---
+
+## More Community Resources
+
+- [Signal K Home page](https://signalk.org/) — The open marine data standard powering KIP
+- [Signal K Discord](https://discord.com/invite/uuZrwz4dCS) — Live chat server: questions, support, contribute and collaborate
+- [Signal K GutHub Project](https://github.com/SignalK) — Feature requests, bug reports, and feedback
+- [SensESP](https://signalk.org/SensESP/) — A Signal K sensor development toolkit for the ESP32 platform
+- [OpenMarine Community](https://openmarine.net/) — OpenPlotter, MacArthur HAT and open source marine tech
+
+## More Community Resources
+
+- [Signal K Home page](https://signalk.org/) — The open marine data standard powering KIP
+- [Signal K Discord](https://discord.com/invite/uuZrwz4dCS) — Live chat server: questions, support, contribute and collaborate
+- [Signal K GutHub Project](https://github.com/SignalK) — Feature requests, bug reports, and feedback
+- [SensESP](https://signalk.org/SensESP/) — A Signal K sensor development toolkit for the ESP32 platform
+- [OpenMarine Community](https://openmarine.net/) — OpenPlotter, MacArthur HAT and open source marine tech
+
+---
+
+> Want to contribute a video or resource? Share your link in the Discord #showcase channel or open a GitHub issue!

package/public/assets/help-docs/configuration.md

@@ -1,4 +1,4 @@
-# Configuration Management
+## Configuration Management
 
 KIP provides a "Login to Server" option that determines where your configuration is stored. It is **strongly recommended** to enable server login in the **Settings** under the **Connectivity** tab. This ensures your configurations are stored remotely on the Signal K server and allows automatic loading of configuration from any device. See the "Creating a Signal K user" section below for information on how to create a user.
 

package/public/assets/help-docs/contact-us.md

@@ -1,16 +1,66 @@
-# Get in Touch
+## Get in Touch
 
-We’d love to hear from you! KIP has an active community on the Signal K Discord server. Join us to get help, explore what others are doing with KIP and Signal K, stay updated with the latest news, and share your ideas.
+We’d love to hear from you. The KIP community is active and friendly—whether you are just getting started, troubleshooting an installation, or brainstorming a new idea.
 
-👉 **Join the conversation in the [KIP Discord channel](https://discord.gg/AMDYT2DQga).**
+👉 **Chat with the community in the [KIP Discord channel](https://discord.gg/AMDYT2DQga).**
+
+Use Discord for quick questions, sharing dashboards, comparing hardware setups, and learning how others integrate KIP with Signal K.
 
 ---
 
-## Feature Requests and Bug Reports
+## When to Use GitHub Issues
+
+Please open a GitHub issue anytime you:
+- Want to request a feature or enhancement
+- Find a bug or regression
+- Notice incorrect documentation
+- Have a reproducible performance or stability problem
+
+🔗 **Create or review issues here: [KIP GitHub Issues](https://github.com/mxtommy/Kip/issues)**
+
+Before creating a new issue:
+1. Use the search box to see if it already exists (add keywords like the widget name, setting, or error text).
+2. If you find an existing issue, add a comment or reaction instead of opening a duplicate.
 
-Have a great idea for a new feature? Found a bug? Let us know!  
-Submit your feature requests or report issues directly on our GitHub project page:
+### What to Include in a Bug Report
+Provide clear, specific details so we can reproduce and fix the problem faster:
+- What you expected vs. what happened
+- Steps to reproduce (numbered list if possible)
+- KIP version (see About / build info) and deployment method (e.g. Signal K app store, manual build)
+- Signal K server version
+- Browser + version (e.g. Firefox 128, Chrome 129, Safari 18)
+- Relevant widget(s) or data paths (e.g. `navigation.speedOverGround`)
+- Screenshots or a short GIF (if visual)
+- Console errors (from browser dev tools) if any
+
+### Feature Requests
+Tell us:
+- The problem you want to solve (not only the solution you imagine)
+- Why it matters / how it improves use onboard
+- Any related Signal K paths or data sources
+- Rough idea of UI needs (new widget? setting? config option?)
+
+If you’re willing to help test or prototype—say so. That speeds things up.
+
+---
+
+## Response Expectations
+- Discord: often same-day community responses; core maintainer availability may vary.
+- GitHub issues: triage typically within a few days; complex features may be discussed before acceptance.
+- Pull requests: reviews depend on scope—small fixes are faster.
+
+If something critical slips through, feel free to politely bump the issue after about a week.
+
+---
+
+## Contributing Beyond Issues
+- Share dashboards, layouts, or usage patterns. Use the Discord #showcase chanel with a few pictures (great inspiration for others!).
+- Help answer other users’ questions on Discord.
+- Test new widgets or configuration flows and give feedback.
+
+---
 
-🔗 **[KIP GitHub Issues](https://github.com/mxtommy/Kip/issues)**
+## Thank You
+Your feedback, curiosity, and ideas directly shape KIP. Whether it’s a tiny typo fix or a major feature concept—every contribution moves the project forward.
 
-Your feedback helps us make KIP even better. Thank you for contributing!
+Fair winds, and happy hacking.

package/public/assets/help-docs/dashboards.md

@@ -1,42 +1,117 @@
-# Managing Dashboards
-You can organize your dashboards from the Dashboards page. To edit a dashboard layout, first visualize the dashboard and unlock it.
-
-## Dashboard Pages
-On the Dashboards page, you can add, reorder, delete, rename, and duplicate dashboards. Each dashboard can have a custom name and icon for easy identification. The dashboard name is briefly visible when you cycle through dashboards. Available actions include:
-- **Long press** a dashboard to delete or duplicate it.
-- **Double tap** a dashboard to rename it and select an icon.
-- **Touch and drag** to reorder dashboards.
-- Use the **(+)** button to add a new dashboard.
-
-When renaming or creating a dashboard, you can choose from a variety of icons to visually represent the dashboard's purpose (e.g., navigation, engine monitoring, weather). Icons are displayed in the dashboard menu for quick recognition.
-
-## Editing Layout
-To edit a dashboard's widgets and arrangement, you need to unlock its layout. View the desired dashboard, access the **Actions menu** on the right-hand side, and tap the bottom **unlock button**. The widgets will become surrounded by dashed borders, indicating you are in edit mode. Actions you can perform while editing a layout include:
-- **Long press** an empty area of the dashboard to add a widget (you may need to free up space first).
-- **Double tap** a widget to edit its configuration.
-- **Touch and drag** a widget to reposition it.
-- **Touch and drag** the edges of a widget to resize it.
-- **Long press** a widget to delete or duplicate it.
-- Use the lower right **Check button** to save changes or the **X button** to discard layout changes.
-
-## Widget Gallery
-KIP's widgets are versatile visual presentation controls with advanced configuration options to suit your needs. Below is a list of available widgets:
-
-- **Numeric Display**: Create gauges to display any numerical data sent by your system, such as SOG, depth, wind speed, VMG, refrigerator temperature, or weather data.
-- **Text Display**: Display textual data sent by your system, such as MPPT state, vessel details, next waypoint, Fusion radio song information, system component statuses, or configuration details.
-- **Date Display**: A timezone-aware control with flexible presentation formatting support.
-- **Boolean Control Panel**: A switchboard to configure and operate remote devices, such as light switches, bilge pumps, solenoids, or any Signal K path that supports boolean PUT operations.
-- **Position**: Displays the vessel's longitude and latitude based on available GPS devices.
-- **Static Label**: A static text widget that allows you to add customizable labels to your dashboard, helping to organize and clarify your layout effectively.
-- **Simple Linear Gauge**: A simple horizontal visual display ideal for electrical numerical data, such as chargers, MPPT, or shunts.
-- **Linear Gauge**: Visually display any numerical data on a vertical or horizontal scale, such as tank and reservoir levels or battery remaining capacity.
-- **Radial Gauge**: Visually display any numerical data on a radial scale, such as boat speed, wind speed, or engine RPM.
-- **Compass Gauge**: A card or marine compass to display directional data, such as heading, bearing to the next waypoint, or wind angle.
-- **Steel Style Gauge**: An old-school look-and-feel radial and linear gauge.
-- **Pitch & Roll**: Horizon-style attitude indicator showing live pitch and roll to monitor trim, heel, and sea-state response.
-- **Wind Steering Display**: A typical sailboat wind gauge.
-- **Freeboard-SK Chart Plotter**: A high-quality Signal K implementation of the Freeboard integration widget.
-- **Autopilot Head**: Operate your autopilot remotely from any device.
-- **Data Chart**: Visualize data trends over time.
-- **Race Timer**: Track regatta start sequences.
-- **Embedded Webpage**: Integrate any web-based content or application into your KIP layout, such as Grafana dashboards, Node-RED dashboards, or your own standalone web app. This widget supports any content that does not cross domains.
+## Managing Dashboards
+Dashboards let you group widgets by task—navigation, engines, energy, weather, racing, night watch, and more. This guide covers creating, organizing, and editing dashboards, plus an overview of available widget types.
+
+---
+
+## 1. Dashboard Pages Panel
+Open the Actions menu and select Settings.
+
+Here you can:
+- Add a new dashboard (+ button)
+- Reorder dashboards (drag with touch or mouse)
+- Rename and pick an icon (double tap or double click)
+- Duplicate a dashboard (long press or long click → Duplicate)
+- Delete a dashboard (long press or long click → Delete)
+
+Choose icons that reflect each dashboard’s purpose (e.g. compass for navigation, droplet for tanks, bolt for power). Icons appear wherever dashboards are listed.
+
+### Gesture / Action Summary
+| Action         | Touch / Mobile         | Mouse / Desktop         |
+|---------------|-----------------------|------------------------|
+| Add dashboard | Tap (+)               | Click (+)              |
+| Reorder       | Drag tile              | Drag tile              |
+| Rename/Icon   | Double tap             | Double click           |
+| Duplicate     | Long press → Duplicate | Long click → Duplicate |
+| Delete        | Long press → Delete    | Long click → Delete    |
+
+---
+
+## 2. Editing Dashboard Layouts
+1. Navigate to the dashboard you want to change (swipe or use dashboard selector).
+2. Open the Actions menu.
+3. Tap the Unlock/Lock button at the bottom to toggle edit mode.
+
+In edit mode, widgets show dashed outlines.
+
+### What You Can Do in Edit Mode
+- Add a widget (long press empty space → Add Widget)
+- Move a widget (drag)
+- Resize a widget (drag edges/corners)
+- Configure a widget (double tap/double click)
+- Duplicate a widget (long press → Duplicate)
+- Delete a widget (long press → Delete, then confirm)
+- Save changes (Check button) or discard (X button) in the lower right
+
+Tip: If you can’t add a widget, free up space by resizing or moving existing ones first.
+
+---
+
+## 3. Workflow: From Idea to Dashboard
+1. Define the purpose (e.g. “Night Nav” = heading, COG, SOG, depth, wind, batteries, minimal brightness)
+2. Create or duplicate a dashboard similar to what you want
+3. Enter edit mode and add required widgets
+4. Configure each widget’s data paths (keep sample times reasonable to reduce churn)
+5. Arrange and size for readability at your viewing distance
+6. Exit edit mode and test switching at real brightness/environment
+
+---
+
+## 4. Widget Gallery (Overview)
+KIP widgets turn Signal K data into readable visuals and controls. Available widget types:
+
+- **Numeric** – Displays numeric data in a clear and concise format, with options to show min/max values and a background minichart for trends.
+- **Text** – Displays text data with customizable color formatting.
+- **Date & Time** – Shows date and time with custom formatting and timezone correction.
+- **Position** – Displays latitude and longitude for location tracking and navigation.
+- **Static Label** – Add customizable labels to organize and clarify your dashboard layout.
+- **Switch Panel** – Group of toggle switches, indicator lights, and press buttons for digital switching and operations.
+- **Slider** – Range slider for adjusting values (e.g. lighting intensity).
+- **Compact Linear** – Simple horizontal linear gauge with a large value label and modern look.
+- **Linear** – Horizontal or vertical linear gauge with zone highlighting.
+- **Radial** – Radial gauge with configurable dials and zone highlighting.
+- **Compass** – Rotating compass gauge with multiple cardinal indicator options.
+- **Level Gauge** – Dual-scale heel angle indicator for trim tuning and sea-state monitoring.
+- **Pitch & Roll** – Horizon-style attitude indicator showing live pitch and roll degrees.
+- **Classic Steel** – Traditional steel-look linear & radial gauges with range sizes and zone highlights.
+- **Windsteer** – Combines wind, wind sectors, heading, COG, and waypoint info for wind steering.
+- **Wind Trends** – Real-time True Wind trends with dual axes for direction and speed, live values, and averages.
+- **Freeboard-SK** – Adds the Freeboard-SK chart plotter as a widget with automatic sign-in.
+- **Autopilot Head** – Typical autopilot controls for compatible Signal K Autopilot devices.
+- **Realtime Data Chart** – Visualizes data on a real-time chart with actuals, averages, and min/max.
+- **Embed Webpage Viewer** – Embeds external web apps (Grafana, Node-RED, etc.) into your dashboard.
+- **Racesteer** – Race steering display fusing polar performance data with live conditions for optimal tactics.
+- **Racer - Start Line Insight** – Set and adjust start line ends, see distance, favored end, and line bias; integrates with Freeboard SK.
+- **Racer - Start Timer** – Advanced racing countdown timer with OCS status and auto dashboard switching.
+- **Countdown Timer** – Simple race start countdown timer with start, pause, sync, and reset options.
+
+---
+
+## 5. Performance & Layout Tips
+- Favor clarity over cramming: leave space around high‑priority values
+- Group related widgets (navigation, energy, engines, environment)
+- Use consistent units per dashboard (e.g. all speeds in knots, all temps in °C or °F—don’t mix)
+- For night dashboards, adjust brightness or use the all‑red theme in Settings → Options → Display
+- Duplicate a working layout before making major changes (easy rollback)
+- Keep sampling intervals modest (1000 ms+) unless fast reaction is essential
+- Know your device’s hardware limits and adjust widget count per dashboard accordingly
+- Avoid embedding too many external webpages—each adds load
+
+---
+
+## 6. Troubleshooting
+| Issue                  | Possible Cause                        | Fix                                                                 |
+|------------------------|---------------------------------------|---------------------------------------------------------------------|
+| Data shows “—” or blank| Path missing/not configured/null value | Open widget config, verify Signal K path exists and updates. Use Data Inspector and Signal K Data Browser to view raw data from the server. |
+| Wrong units            | Default convert unit used              | Edit widget config paths and set the desired target unit.            |
+| Slow dashboard switching| Excessive data sampling/too many widgets| Increase sample times; remove unused widgets. Split widgets into separate dashboards. Optimize system resource usage. |
+| Embedded page blank    | Cross‑origin blocked                   | See "Embed Page Viewer" help section.                               |
+
+---
+
+## 7. Next Steps
+See also:
+- Remote Control (switch dashboards on unattended displays)
+- Night Mode (automatic theme + brightness)
+- Contact / Issues (report widget feature ideas)
+
+Refine incrementally—small improvements keep dashboards readable and reliable.

package/public/assets/help-docs/datainspector.md

@@ -1,4 +1,4 @@
-# Data Inspector
+## Data Inspector
 
 The Data Inspector is a powerful tool in KIP that allows you to view all Signal K paths and the data received from the server in real time. It provides detailed insights into the data being transmitted, including metadata, sources, and supported operations. This guide explains how to use the Data Inspector effectively.
 

package/public/assets/help-docs/datasets.md

@@ -1,4 +1,4 @@
-# Datasets and Data Chart Widget
+## Datasets and Data Chart Widget
 
 Datasets and the Data Chart widget work together to provide real-time data visualization in KIP. They allow you to collect and display historical data trends for Signal K paths, enabling better decision-making and monitoring. This guide explains how to configure and use Datasets and the Data Chart widget effectively.
 

package/public/assets/help-docs/embedwidget.md

@@ -1,4 +1,4 @@
-# Using the Embed Page Viewer Widget
+## Using the Embed Page Viewer Widget
 
 The Embed Page Viewer widget allows you to display external web pages or web applications directly within your dashboard. By default, the Embed Page Viewer widget does not allow input (touch, mouse and keyboard interactions) with the content in the Embed. To enable interactions, check the setting the widget's options.