From 405e0fb221838d7ef9b79aa4c7b878ea51f0e5a9 Mon Sep 17 00:00:00 2001
From: Amjad Alsharafi <26300843+Amjad50@users.noreply.github.com>
Date: Sat, 1 Feb 2025 23:23:09 +0800
Subject: [PATCH] Documentation: Add `firefly iii` docs

Signed-off-by: Amjad Alsharafi <26300843+Amjad50@users.noreply.github.com>
---
 docs/widgets/services/firefly.md | 17 +++++++++++++++++
 docs/widgets/services/index.md   |  1 +
 mkdocs.yml                       |  1 +
 3 files changed, 19 insertions(+)
 create mode 100644 docs/widgets/services/firefly.md

diff --git a/docs/widgets/services/firefly.md b/docs/widgets/services/firefly.md
new file mode 100644
index 000000000..38793ce29
--- /dev/null
+++ b/docs/widgets/services/firefly.md
@@ -0,0 +1,17 @@
+---
+title: Firefly III
+description: Firefly III Widget Configuration
+---
+
+Learn more about [Firefly III](https://www.firefly-iii.org/).
+
+Find your API key under `Options > Profile > OAuth > Personal Access Tokens`.
+
+Allowed fields: `["networth" ,"budget"]`.
+
+```yaml
+widget:
+  type: firefly
+  url: https://firefly.host.or.ip
+  key: personalaccesstoken.personalaccesstoken.personalaccesstoken
+```
diff --git a/docs/widgets/services/index.md b/docs/widgets/services/index.md
index 894a31f6e..2e3965820 100644
--- a/docs/widgets/services/index.md
+++ b/docs/widgets/services/index.md
@@ -33,6 +33,7 @@ You can also find a list of all available service widgets in the sidebar navigat
 - [ESPHome](esphome.md)
 - [EVCC](evcc.md)
 - [Fileflows](fileflows.md)
+- [Firefly III](firefly.md)
 - [Flood](flood.md)
 - [FreshRSS](freshrss.md)
 - [Frigate](frigate.md)
diff --git a/mkdocs.yml b/mkdocs.yml
index fa2188ad5..958c3398c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -56,6 +56,7 @@ nav:
           - widgets/services/esphome.md
           - widgets/services/evcc.md
           - widgets/services/fileflows.md
+          - widgets/services/firefly.md
           - widgets/services/flood.md
           - widgets/services/freshrss.md
           - widgets/services/frigate.md