From 0e0dd23f2b770c8485ffa2f076080c8612a4101c Mon Sep 17 00:00:00 2001 From: Adam Setch Date: Sun, 1 Nov 2026 10:37:57 -0500 Subject: [PATCH 1/2] docs(faq): document reduce motion Explain that Gitify follows the operating system Reduce Motion setting, which makes notification dismissal instant. Add platform guidance for macOS, Windows, and Linux, and note that the action still runs in the background. --- src/faqs/using-gitify/keyboard-shortcuts.md | 2 +- src/faqs/using-gitify/reduce-motion.md | 17 +++++++++++++++++ .../using-gitify/unsubscribe-from-thread.md | 2 +- src/faqs/using-gitify/updating.md | 2 +- 4 files changed, 20 insertions(+), 3 deletions(-) create mode 100644 src/faqs/using-gitify/reduce-motion.md diff --git a/src/faqs/using-gitify/keyboard-shortcuts.md b/src/faqs/using-gitify/keyboard-shortcuts.md index c1acb93..7fffa37 100644 --- a/src/faqs/using-gitify/keyboard-shortcuts.md +++ b/src/faqs/using-gitify/keyboard-shortcuts.md @@ -1,7 +1,7 @@ --- title: "How do keyboard shortcuts work?" category: "Using Gitify" -order: 3 +order: 4 --- Gitify includes keyboard shortcuts for common actions. diff --git a/src/faqs/using-gitify/reduce-motion.md b/src/faqs/using-gitify/reduce-motion.md new file mode 100644 index 0000000..b5833d0 --- /dev/null +++ b/src/faqs/using-gitify/reduce-motion.md @@ -0,0 +1,17 @@ +--- +title: "How do I make notification dismissal instant?" +category: "Using Gitify" +order: 3 +--- + +Turning on your operating system's Reduce Motion setting makes Gitify dismiss a notification immediately instead of sliding and fading the row out. + +To enable Reduce Motion: + +- **macOS** — open **System Settings → Accessibility → Display**, then turn on **Reduce motion** +- **Windows** — open **Settings → Accessibility → Visual effects**, then turn off **Animation effects** +- **Linux** — use your desktop environment's Reduce Motion or animation setting + +This is useful on slow connections and when clearing several notifications quickly. + +> The notification action still runs in the background. If it fails, the notification returns with the usual error feedback. diff --git a/src/faqs/using-gitify/unsubscribe-from-thread.md b/src/faqs/using-gitify/unsubscribe-from-thread.md index ea78168..81ec400 100644 --- a/src/faqs/using-gitify/unsubscribe-from-thread.md +++ b/src/faqs/using-gitify/unsubscribe-from-thread.md @@ -1,7 +1,7 @@ --- title: "What does the Unsubscribe from Thread option do?" category: "Using Gitify" -order: 4 +order: 5 --- **Unsubscribe from Thread** stops future notifications for that thread until you comment on it or get an **@mention**. diff --git a/src/faqs/using-gitify/updating.md b/src/faqs/using-gitify/updating.md index 549622d..010292f 100644 --- a/src/faqs/using-gitify/updating.md +++ b/src/faqs/using-gitify/updating.md @@ -1,7 +1,7 @@ --- title: "How do I update Gitify?" category: "Using Gitify" -order: 5 +order: 6 --- Gitify checks for updates when it starts and every 24 hours. From 4d47319c66610fd5ca9a5be96aa6acb4997eea09 Mon Sep 17 00:00:00 2001 From: Adam Setch Date: Sun, 1 Nov 2026 10:50:25 -0500 Subject: [PATCH 2/2] docs(faq): add accessibility section Move Reduce Motion into a dedicated Accessibility category and add FAQs for contrast, color-blind themes, zoom, and transparency. Link the appearance article to the detailed accessibility answers. --- src/faqs/accessibility/contrast-and-color.md | 13 +++++++++++++ .../reduce-motion.md | 4 ++-- src/faqs/accessibility/transparency.md | 17 +++++++++++++++++ src/faqs/using-gitify/appearance.md | 2 ++ src/faqs/using-gitify/keyboard-shortcuts.md | 2 +- .../using-gitify/unsubscribe-from-thread.md | 2 +- src/faqs/using-gitify/updating.md | 2 +- src/pages/faq.astro | 1 + 8 files changed, 38 insertions(+), 5 deletions(-) create mode 100644 src/faqs/accessibility/contrast-and-color.md rename src/faqs/{using-gitify => accessibility}/reduce-motion.md (95%) create mode 100644 src/faqs/accessibility/transparency.md diff --git a/src/faqs/accessibility/contrast-and-color.md b/src/faqs/accessibility/contrast-and-color.md new file mode 100644 index 0000000..ea3976e --- /dev/null +++ b/src/faqs/accessibility/contrast-and-color.md @@ -0,0 +1,13 @@ +--- +title: "How do I improve contrast and color readability?" +category: "Accessibility" +order: 1 +--- + +Gitify offers high-contrast and color-blind friendly options, and it follows your operating system's increase-contrast setting. + +- **Increase contrast** — in **Settings → Appearance**, turn on **Increase contrast**. Gitify also applies high-contrast colors automatically when your system's increase-contrast setting is on. +- **Color-blind themes** — in **Settings → Appearance → Theme**, choose a color-blind or Tritanopia variant. +- **Zoom** — use the zoom controls in **Settings → Appearance** to enlarge the interface. + +The contrast and color-blind options are available with the **Classic** design. Glass follows the system increase-contrast setting by switching to solid surfaces. diff --git a/src/faqs/using-gitify/reduce-motion.md b/src/faqs/accessibility/reduce-motion.md similarity index 95% rename from src/faqs/using-gitify/reduce-motion.md rename to src/faqs/accessibility/reduce-motion.md index b5833d0..b7c0ecc 100644 --- a/src/faqs/using-gitify/reduce-motion.md +++ b/src/faqs/accessibility/reduce-motion.md @@ -1,7 +1,7 @@ --- title: "How do I make notification dismissal instant?" -category: "Using Gitify" -order: 3 +category: "Accessibility" +order: 0 --- Turning on your operating system's Reduce Motion setting makes Gitify dismiss a notification immediately instead of sliding and fading the row out. diff --git a/src/faqs/accessibility/transparency.md b/src/faqs/accessibility/transparency.md new file mode 100644 index 0000000..3398870 --- /dev/null +++ b/src/faqs/accessibility/transparency.md @@ -0,0 +1,17 @@ +--- +title: "How do I reduce transparency?" +category: "Accessibility" +order: 2 +--- + +Gitify's Glass design follows your operating system's Reduce Transparency setting and switches to solid surfaces when it is on. + +To enable Reduce Transparency: + +- **macOS** — open **System Settings → Accessibility → Display**, then turn on **Reduce transparency** +- **Windows** — open **Settings → Accessibility → Visual effects**, then turn off **Transparency effects** +- **Linux** — use your desktop environment's Reduce Transparency setting + +Gitify also switches Glass to solid surfaces when your system's increase-contrast setting is on. + +> Reduce Transparency only changes the Glass design. The Classic design is already solid. diff --git a/src/faqs/using-gitify/appearance.md b/src/faqs/using-gitify/appearance.md index 31e5249..ef5c35f 100644 --- a/src/faqs/using-gitify/appearance.md +++ b/src/faqs/using-gitify/appearance.md @@ -13,3 +13,5 @@ You can change how Gitify looks from **Settings → Appearance**. - **Zoom** — zoom in, zoom out, or reset zoom for the whole app - **Show account header** — show the account header in the sidebar - **Show full notification title** — show full notification titles instead of truncating them + +Related: [How do I improve contrast and color readability?](#contrast-and-color) · [How do I reduce transparency?](#transparency) diff --git a/src/faqs/using-gitify/keyboard-shortcuts.md b/src/faqs/using-gitify/keyboard-shortcuts.md index 7fffa37..c1acb93 100644 --- a/src/faqs/using-gitify/keyboard-shortcuts.md +++ b/src/faqs/using-gitify/keyboard-shortcuts.md @@ -1,7 +1,7 @@ --- title: "How do keyboard shortcuts work?" category: "Using Gitify" -order: 4 +order: 3 --- Gitify includes keyboard shortcuts for common actions. diff --git a/src/faqs/using-gitify/unsubscribe-from-thread.md b/src/faqs/using-gitify/unsubscribe-from-thread.md index 81ec400..ea78168 100644 --- a/src/faqs/using-gitify/unsubscribe-from-thread.md +++ b/src/faqs/using-gitify/unsubscribe-from-thread.md @@ -1,7 +1,7 @@ --- title: "What does the Unsubscribe from Thread option do?" category: "Using Gitify" -order: 5 +order: 4 --- **Unsubscribe from Thread** stops future notifications for that thread until you comment on it or get an **@mention**. diff --git a/src/faqs/using-gitify/updating.md b/src/faqs/using-gitify/updating.md index 010292f..549622d 100644 --- a/src/faqs/using-gitify/updating.md +++ b/src/faqs/using-gitify/updating.md @@ -1,7 +1,7 @@ --- title: "How do I update Gitify?" category: "Using Gitify" -order: 6 +order: 5 --- Gitify checks for updates when it starts and every 24 hours. diff --git a/src/pages/faq.astro b/src/pages/faq.astro index f6097ec..a34056f 100644 --- a/src/pages/faq.astro +++ b/src/pages/faq.astro @@ -14,6 +14,7 @@ interface FAQFrontmatter { const CATEGORY_ORDER = [ 'Getting Started', 'Using Gitify', + 'Accessibility', 'Troubleshooting', 'Contributing', ];