fix: skip maximise if starting to tray

Signed-off-by: Mihai <cristian@mihaimuresan.com>

.github/workflows/build.yml

@@ -1,7 +1,8 @@
 on:
   push:
     branches:
-      - "**"
+      - main
+  pull_request:
 
 jobs:
   build:
@@ -15,16 +16,10 @@ jobs:
       - name: Checkout assets
         run: git -c submodule."assets".update=checkout submodule update --init assets
 
-      - name: Install pnpm
+      - name: Setup Mise
-        uses: pnpm/action-setup@v4
+        uses: immich-app/devtools/actions/use-mise@cd24790a7f5f6439ac32cc94f5523cb2de8bfa8c # use-mise-action-v1.1.0
         with:
-          run_install: false
+          github-token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Install Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: "pnpm"
 
       - name: Install dependencies
         run: pnpm install

.github/workflows/git-town.yml

@@ -0,0 +1,19 @@
+name: Git Town
+
+on:
+  pull_request:
+
+jobs:
+  git-town:
+    name: Display the branch stack
+    runs-on: ubuntu-slim
+
+    if: ${{ !startsWith(github.head_ref, 'release-please--') }}
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+      - uses: stoatchat/action-git-town@4bc5c942e4603bffa0806b51d5fe5f0bc5deb0ac

.github/workflows/release-webhook.yml

@@ -12,8 +12,12 @@ jobs:
 
     steps:
       - name: Send release notification webhook
+        env:
+          TAG_NAME: ${{ github.event.release.tag_name }}
+          REPOSITORY: ${{ github.repository }}
+          WEBHOOK_URL: ${{ secrets.STOAT_WEBHOOK_UPDATES_URL }}
         run: |
-          RELEASE_URL="https://github.com/${{ github.repository }}/releases/tag/${{ github.event.release.tag_name }}"
+          RELEASE_URL="https://github.com/${REPOSITORY}/releases/tag/${TAG_NAME}"
-          curl -X POST "${{ secrets.STOAT_WEBHOOK_UPDATES_URL }}" \
+          curl -X POST "$WEBHOOK_URL" \
             -H "Content-Type: application/json" \
-            -d "{\"content\": \"$RELEASE_URL\"}"
+            -d "{\"content\": \"$RELEASE_URL\"}"

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.2.0"
+  ".": "1.3.0"
 }

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.3.0](https://github.com/stoatchat/for-desktop/compare/v1.2.0...v1.3.0) (2026-02-18)
+
+
+### Features
+
+* minimise-to-tray-on-startup ([#126](https://github.com/stoatchat/for-desktop/issues/126)) ([8284117](https://github.com/stoatchat/for-desktop/commit/8284117e76c0fcff4091de3ef623014e4594a593))
+* Reload/Refresh shortcut ([#119](https://github.com/stoatchat/for-desktop/issues/119)) ([2e99b19](https://github.com/stoatchat/for-desktop/commit/2e99b19353fbd45d9fdf1d148bae3a8a19c788ed))
+
+
+### Bug Fixes
+
+* Add common zoom-reset shortcut. ([#112](https://github.com/stoatchat/for-desktop/issues/112)) ([def29f9](https://github.com/stoatchat/for-desktop/commit/def29f9b3c1205944aab58beb8000815d41633b5))
+* allow CTRL+"+" to also zoom in. ([#108](https://github.com/stoatchat/for-desktop/issues/108)) ([2b962c5](https://github.com/stoatchat/for-desktop/commit/2b962c5d066787601223368ee7dcc1e46a345b8a))
+* App-maximized-2nd-monitor ([897d706](https://github.com/stoatchat/for-desktop/commit/897d706983a347938a2fb42ba8e58e40794bba13))
+* don't re-enable abutostart ([63b9ea8](https://github.com/stoatchat/for-desktop/commit/63b9ea818a9f32ca8535948e18752726c0f50a12))
+* firstLaunch = false after initial setup ([#131](https://github.com/stoatchat/for-desktop/issues/131)) ([63b9ea8](https://github.com/stoatchat/for-desktop/commit/63b9ea818a9f32ca8535948e18752726c0f50a12))
+* flatpak icons not building correctly and wayland support ([#132](https://github.com/stoatchat/for-desktop/issues/132)) ([ffe17ec](https://github.com/stoatchat/for-desktop/commit/ffe17ec2c54fca6967435b8a4ada7fa8d4da7b33))
+* replace default dialog with notification ([#98](https://github.com/stoatchat/for-desktop/issues/98)) ([7d2f296](https://github.com/stoatchat/for-desktop/commit/7d2f296ca72bbd7ad694c66a917d47067f883fc5))
+* toggle window visibility on tray click instead of always showing ([#103](https://github.com/stoatchat/for-desktop/issues/103)) ([742a95f](https://github.com/stoatchat/for-desktop/commit/742a95f3cb820c5b5398c815b7b45017b6b06053))
+* try to restore maximised windows to correct display ([#92](https://github.com/stoatchat/for-desktop/issues/92)) ([897d706](https://github.com/stoatchat/for-desktop/commit/897d706983a347938a2fb42ba8e58e40794bba13))
+* use template icon for macOS tray, use higher res icons for other platforms ([#130](https://github.com/stoatchat/for-desktop/issues/130)) ([58ccb63](https://github.com/stoatchat/for-desktop/commit/58ccb63d23541a03e05a48a37a98f883a2ba0d3f))
+
 ## [1.2.0](https://github.com/stoatchat/for-desktop/compare/v1.1.12...v1.2.0) (2026-02-14)
 
 

README.md

@@ -13,6 +13,14 @@ Application for Windows, macOS, and Linux.
 </div>
 <br/>
 
+## Installation
+
+<a href="https://repology.org/project/stoat-desktop/versions">
+    <img src="https://repology.org/badge/vertical-allrepos/stoat-desktop.svg" alt="Packaging status" align="right">
+</a>
+
+- All downloads and instructions for Stoat can be found on our [Website](https://stoat.chat/download).
+
 ## Development Guide
 
 _Contribution guidelines for Desktop app TBA!_

chat.stoat.StoatDesktop.desktop

@@ -0,0 +1,11 @@
+[Desktop Entry]
+Name=Stoat
+Comment=Open source, user-first chat platform
+Exec=stoat-desktop
+Terminal=false
+Type=Application
+Icon=chat.stoat.StoatDesktop
+Categories=Network;InstantMessaging
+StartupWMClass=stoat-desktop
+X-Desktop-File-Install-Version=0.26
+X-Flatpak=chat.stoat.StoatDesktop

chat.stoat.StoatDesktop.metainfo.xml

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<component type="desktop">
+  <id>chat.stoat.StoatDesktop</id>
+  <launchable type="desktop-id">chat.stoat.StoatDesktop.desktop</launchable>
+  <name>Stoat</name>
+  <developer id="chat.stoat">
+    <name>Revolt Platforms Ltd</name>
+  </developer>
+  <summary>Open source, user-first chat platform</summary>
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>AGPL-3.0</project_license>
+  <icon type="remote" height="256" width="256">
+    https://raw.githubusercontent.com/stoatchat/assets/f106946659af67ad4f008588ac51570029b2fd47/desktop/icon.png</icon>
+  <description>
+    <p>Stoat is an open source, user-first chat platform. Send messages, share
+      images, mention users, and join voice channels — all from a native desktop
+      application.</p>
+  </description>
+  <screenshots>
+    <screenshot type="default">
+      <caption>Main window</caption>
+      <image>screenshot.png</image>
+    </screenshot>
+  </screenshots>
+  <releases>
+    <release date="2026-02-14" version="1.2.0">
+      <description>
+        <p>Features:</p>
+        <ul>
+          <li>New Branding</li>
+          <li>Persist and restore window size and position</li>
+        </ul>
+        <p>Bug Fixes:</p>
+        <ul>
+          <li>App Autostart</li>
+        </ul>
+      </description>
+    </release>
+    <release date="2025-12-29" version="1.1.12">
+      <description>
+        <p>Bug fixes:</p>
+        <ul>
+          <li>Add NixOS compatibility for electron startup</li>
+          <li>Correctly load badge count; expose to renderer</li>
+          <li>Fix event listener accumulation from rpc client</li>
+          <li>Fix macOS tray icon size</li>
+          <li>Fix RPC largeImageText</li>
+          <li>Use the correct argument for auto start</li>
+        </ul>
+      </description>
+    </release>
+  </releases>
+  <url type="bugtracker">https://github.com/stoatchat/for-desktop/issues</url>
+  <url type="homepage">https://stoat.chat</url>
+  <url type="vcs-browser">https://github.com/stoatchat/for-desktop</url>
+  <content_rating type="oars-1.1">
+    <content_attribute id="social-chat">intense</content_attribute>
+    <content_attribute id="social-info">intense</content_attribute>
+    <content_attribute id="social-audio">intense</content_attribute>
+    <content_attribute id="social-contacts">intense</content_attribute>
+  </content_rating>
+  <requires>
+    <display_length compare="ge">940</display_length>
+    <internet>always</internet>
+  </requires>
+  <supports>
+    <control>keyboard</control>
+    <control>pointing</control>
+  </supports>
+</component>

default.nix

@@ -1,16 +1,13 @@
-{
+{ pkgs ? import (fetchTarball {
-  pkgs ? import <nixpkgs> { },
+    url = "https://github.com/NixOS/nixpkgs/archive/77ef7a29d276c6d8303aece3444d61118ef71ac2.tar.gz";
+    sha256 = "0pm4l48jq8plzrrrisimahxqlcpx7qqq9c99hylmf7p3zlc3phsy";
+  }) {},
 }:
 
 pkgs.mkShell rec {
-  buildInputs = [
+  buildInputs = with pkgs; [
     # Tools
-    pkgs.git
+    pkgs.mise
-    pkgs.gh
-
-    # Node
-    pkgs.nodejs
-    pkgs.nodejs.pkgs.pnpm
 
     # Electron
     (pkgs.writeShellScriptBin "electron-nix" ''
@@ -29,5 +26,15 @@ pkgs.mkShell rec {
     pkgs.flatpak-builder
     pkgs.elfutils
     # flatpak remote-add --if-not-exists --user flathub https://dl.flathub.org/repo/flathub.flatpakrepo
+    
+    (writeShellScriptBin "fish" ''
+      exec ${pkgs.fish}/bin/fish -C 'mise activate fish | source' "$@"
+    '')
   ];
+
+  shellHook = ''
+    export ELECTRON_OVERRIDE_DIST_PATH="${pkgs.electron}/bin"
+    export MISE_NODE_COMPILE=false
+    eval "$(mise activate bash)"
+  '';
 }

forge.config.ts

@@ -58,8 +58,15 @@ if (!process.env.PLATFORM) {
         description: STRINGS.description,
         productName: STRINGS.name,
         productDescription: STRINGS.description,
-        runtimeVersion: "21.08",
+        runtimeVersion: "25.08",
-        icon: `${ASSET_DIR}/icon.png`,
+        icon: {
+          "16x16": `${ASSET_DIR}/hicolor/16x16.png`,
+          "32x32": `${ASSET_DIR}/hicolor/32x32.png`,
+          "64x64": `${ASSET_DIR}/hicolor/64x64.png`,
+          "128x128": `${ASSET_DIR}/hicolor/128x128.png`,
+          "256x256": `${ASSET_DIR}/hicolor/256x256.png`,
+          "512x512": `${ASSET_DIR}/hicolor/512x512.png`,
+        } as unknown,
         categories: ["Network"],
         modules: [
           // use the latest zypak -- Electron sandboxing for Flatpak
@@ -77,7 +84,7 @@ if (!process.env.PLATFORM) {
         finishArgs: [
           // default arguments found by running
           // DEBUG=electron-installer-flatpak* pnpm make
-          "--socket=x11",
+          "--socket=fallback-x11",
           "--share=ipc",
           "--device=dri",
           "--socket=pulseaudio",

mise.toml

@@ -0,0 +1,5 @@
+[tools]
+node = "25.4.0"
+pnpm = "10.28.1"
+gh = "2.25.0"
+"github:git-town/git-town" = "22.4.0"

package.json

@@ -1,7 +1,7 @@
 {
   "name": "stoat-desktop",
   "productName": "stoat-desktop",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "main": ".vite/build/main.js",
   "repository": "stoatchat/desktop",
   "scripts": {

pnpm-workspace.yaml

@@ -1,7 +1,9 @@
 nodeLinker: hoisted
 
 onlyBuiltDependencies:
+  - bufferutil
   - electron
   - electron-winstaller
   - esbuild
   - register-scheme
+  - utf-8-validate

src/main.ts

@@ -1,6 +1,6 @@
-import { updateElectronApp } from "update-electron-app";
+import { IUpdateInfo, updateElectronApp } from "update-electron-app";
 
-import { BrowserWindow, app, shell } from "electron";
+import { BrowserWindow, Notification, app, shell } from "electron";
 import started from "electron-squirrel-startup";
 
 import { autoLaunch } from "./native/autoLaunch";
@@ -24,21 +24,33 @@ if (!config.hardwareAcceleration) {
 // ensure only one copy of the application can run
 const acquiredLock = app.requestSingleInstanceLock();
 
+const onNotifyUser = (_info: IUpdateInfo) => {
+  const notification = new Notification({
+    title: "Update Available",
+    body: "Restart the app to install the update.",
+    silent: true,
+  });
+
+  notification.show();
+};
+
 if (acquiredLock) {
   // start auto update logic
-  updateElectronApp();
+  updateElectronApp({ onNotifyUser });
 
   // create and configure the app when electron is ready
   app.on("ready", () => {
+    // create window and application contexts
+    createMainWindow();
+
     // enable auto start on Windows and MacOS
     if (config.firstLaunch) {
       if (process.platform === "win32" || process.platform === "darwin") {
         autoLaunch.enable();
       }
+      config.firstLaunch = false;
     }
 
-    // create window and application contexts
-    createMainWindow();
     initTray();
     initDiscordRpc();
 

src/native/config.ts

@@ -16,6 +16,9 @@ const schema = {
   minimiseToTray: {
     type: "boolean",
   } as JSONSchema.Boolean,
+  startMinimisedToTray: {
+    type: "boolean",
+  } as JSONSchema.Boolean,
   spellchecker: {
     type: "boolean",
   } as JSONSchema.Boolean,
@@ -29,16 +32,16 @@ const schema = {
     type: "object",
     properties: {
       x: {
-        type: 'number'
+        type: "number",
       } as JSONSchema.Number,
       y: {
-        type: 'number'
+        type: "number",
       } as JSONSchema.Number,
       width: {
-        type: 'number'
+        type: "number",
       } as JSONSchema.Number,
       height: {
-        type: 'number'
+        type: "number",
       } as JSONSchema.Number,
       isMaximised: {
         type: "boolean",
@@ -53,6 +56,7 @@ const store = new Store({
     firstLaunch: true,
     customFrame: true,
     minimiseToTray: true,
+    startMinimisedToTray: false,
     spellchecker: true,
     hardwareAcceleration: true,
     discordRpc: true,
@@ -75,6 +79,7 @@ class Config {
       firstLaunch: this.firstLaunch,
       customFrame: this.customFrame,
       minimiseToTray: this.minimiseToTray,
+      startMinimisedToTray: this.startMinimisedToTray,
       spellchecker: this.spellchecker,
       hardwareAcceleration: this.hardwareAcceleration,
       discordRpc: this.discordRpc,
@@ -123,6 +128,21 @@ class Config {
     this.sync();
   }
 
+  get startMinimisedToTray() {
+    return (store as never as { get(k: string): boolean }).get(
+      "startMinimisedToTray",
+    );
+  }
+
+  set startMinimisedToTray(value: boolean) {
+    (store as never as { set(k: string, value: boolean): void }).set(
+      "startMinimisedToTray",
+      value,
+    );
+
+    this.sync();
+  }
+
   get spellchecker() {
     return (store as never as { get(k: string): boolean }).get("spellchecker");
   }

src/native/tray.ts

@@ -1,6 +1,7 @@
 import { Menu, Tray, nativeImage } from "electron";
 
 import trayIconAsset from "../../assets/desktop/icon.png?asset";
+import macOsTrayIconAsset from "../../assets/desktop/iconTemplate.png?asset";
 import { version } from "../../package.json";
 
 import { mainWindow, quitApp } from "./window";
@@ -10,17 +11,16 @@ let tray: Tray = null;
 
 // Create and resize tray icon for macOS
 function createTrayIcon() {
-  const image = nativeImage.createFromDataURL(trayIconAsset);
+  if (process.platform === "darwin") {
-  const resized = image.resize({ width: 20, height: 20 });
+    const image = nativeImage.createFromDataURL(macOsTrayIconAsset);
-
+    const resized = image.resize({ width: 20, height: 20 });
-  // Mark as template image so it adapts to dark/light mode
+    resized.setTemplateImage(true);
-  resized.setTemplateImage(true);
+    return resized;
-
+  } else {
-  return resized;
+    return nativeImage.createFromDataURL(trayIconAsset);
+  }
 }
 
-// trayIcon.setTemplateImage(true);
-
 export function initTray() {
   const trayIcon = createTrayIcon();
   tray = new Tray(trayIcon);
@@ -28,8 +28,12 @@ export function initTray() {
   tray.setToolTip("Stoat for Desktop");
   tray.setImage(trayIcon);
   tray.on("click", () => {
-    mainWindow.show();
+    if (mainWindow.isVisible()) {
-    mainWindow.focus();
+     mainWindow.hide();
+    } else {
+     mainWindow.show();
+     mainWindow.focus();
+    }
   });
 }
 

src/native/window.ts

@@ -36,6 +36,10 @@ const windowIcon = nativeImage.createFromDataURL(windowIconAsset);
  * Create the main application window
  */
 export function createMainWindow() {
+  // (CLI arg --hidden or config)
+  const startHidden =
+    app.commandLine.hasSwitch("hidden") || config.startMinimisedToTray;
+
   // create the window
   mainWindow = new BrowserWindow({
     minWidth: 300,
@@ -45,6 +49,7 @@ export function createMainWindow() {
     backgroundColor: "#191919",
     frame: !config.customFrame,
     icon: windowIcon,
+    show: !startHidden,
     webPreferences: {
       // relative to `.vite/build`
       preload: join(__dirname, "preload.js"),
@@ -57,19 +62,25 @@ export function createMainWindow() {
   // hide the options
   mainWindow.setMenu(null);
 
-  // maximise the window if it was maximised before
-  if (config.windowState.isMaximised) {
-    mainWindow.maximize();
-  }
-
   // restore last position if it was moved previously
-  if(config.windowState.x > 0 || config.windowState.y > 0) {
+  if (config.windowState.x > 0 || config.windowState.y > 0) {
-    mainWindow.setPosition(config.windowState.x ?? 0, config.windowState.y ?? 0);
+    mainWindow.setPosition(
+      config.windowState.x ?? 0,
+      config.windowState.y ?? 0,
+    );
   }
 
   // restore last size if it was resized previously
-  if(config.windowState.width > 0 && config.windowState.height > 0) {
+  if (config.windowState.width > 0 && config.windowState.height > 0) {
-    mainWindow.setSize(config.windowState.width ?? 1280, config.windowState.height ?? 720);
+    mainWindow.setSize(
+      config.windowState.width ?? 1280,
+      config.windowState.height ?? 720,
+    );
+  }
+
+  // maximise the window if it was maximised before
+  if (config.windowState.isMaximised && !startHidden) {
+    mainWindow.maximize();
   }
 
   // load the entrypoint
@@ -105,7 +116,7 @@ export function createMainWindow() {
 
   // rebind zoom controls to be more sensible
   mainWindow.webContents.on("before-input-event", (event, input) => {
-    if (input.control && input.key === "=") {
+    if (input.control && (input.key === "=" || input.key === "+")) {
       // zoom in (+)
       event.preventDefault();
       mainWindow.webContents.setZoomLevel(
@@ -117,6 +128,16 @@ export function createMainWindow() {
       mainWindow.webContents.setZoomLevel(
         mainWindow.webContents.getZoomLevel() - 1,
       );
+    } else if (input.control && input.key === "0") {
+      // reset zoom to default.
+      event.preventDefault();
+      mainWindow.webContents.setZoomLevel(0);
+    } else if (
+      input.key === "F5" ||
+      ((input.control || input.meta) && input.key.toLowerCase() === "r")
+    ) {
+      event.preventDefault();
+      mainWindow.webContents.reload();
     }
   });