docs: add PWA installation instructions to README and create dedicated PWA documentation

Author: JakobLichterfeld

CHANGELOG.md

@@ -34,6 +34,7 @@
 - docs: update security policy to emphasize network-level protection ([27172cba](https://github.com/teslamate-org/teslamate/commit/27172cba54782f9a8eb7fdd9ea3a481dfd9d8f2b) - @JakobLichterfeld)
 - docs: fix typo in DATABASE_SSL_SNI description (#5346 - @dashitongzhi)
 - docs: update upgrading instructions to emphasize backup before updating more clearly (#5453 - @JakobLichterfeld)
+- docs: add PWA installation instructions to README and create dedicated PWA documentation (#5455 - @JakobLichterfeld)
 
 ## [4.0.1] - 2026-06-14
 

README.md

@@ -47,6 +47,10 @@ The documentation is available at [https://docs.teslamate.org](https://docs.tesl
 - Import from TeslaFi and tesla-apiscraper
 - Customizable theme mode (light, dark, or system default)
 
+### Use as App — Progressive Web App (PWA)
+
+TeslaMate can be installed as a Progressive Web App (PWA) from your self‑hosted instance. Add your instance to your device's home screen and use it like a native app. See the PWA documentation: [Use as App — Progressive Web App (PWA)](website/docs/pwa.md).
+
 ### Dashboards
 
 Sample screenshots of bundled dashboards can be seen by clicking the links below.

website/docs/pwa.md

@@ -0,0 +1,18 @@
+---
+title: Use as App — Progressive Web App (PWA)
+---
+
+## Use as App — Progressive Web App (PWA)
+
+TeslaMate can be installed as a Progressive Web App (PWA) from your own self‑hosted instance. Installing your instance adds it to the home screen and provides an app‑like experience (offline cache, standalone window).
+
+### Requirements
+
+- The TeslaMate URL must be served over HTTPS.
+
+### Install
+
+- Android (Chrome / others): open your TeslaMate URL → browser menu (⋮) → "Add to Home screen" → follow prompts.
+- iOS (only use Safari): open your TeslaMate URL → Share → "Add to Home Screen" → confirm.
+- Desktop (Chrome / others): open your TeslaMate URL → click the install icon in the address bar or Menu → "Install App".
+- For browser‑specific details consult your browser's documentation.

website/sidebars.js

@@ -21,7 +21,7 @@ module.exports = {
             },
           ],
         },
-
+        "pwa",
         "faq",
         "screenshots",
       ],