115 build system housekeeping modernisation windows linux (#174)

* 120 packagejson build section cleanup (#140)

* ci: .env added for windows store build

* fix: nameing cleanup (#136)

* chore: moved internal meta to new section (#137)

* chore: cleaned up scripts

* 119 build script redesign (#165)

* 141 create metadata injection script inject metadatajs (#158)

* template meta injector(untested)

* Clean YYYY‑MM‑DD in the footer

* 142 implement dev build script build devjs (#159)

* template meta injector(untested)

* dev script working |meta script val

* 143 implement test build script build testjs (#160)

* add: test script for new test builds

* updated the meta scrapper to include the new meta

* updated the meta scrapper to include the new meta

* removed from root now in scripts

* new: release pipline (dry run tested only) (#161)

* new: linux build script (testing merge if good) (#162)

* 146 create platform helper module helpersplatformjs (#163)

* new: helper module for future updater

* feat: added new helper non invasive for testing

* 147 refactor packagejson build entrypoints (#164)

* chore: removed un needed old script

* updated quickstart for new commands

* 116 updater modernisation windows linux (#167)

* chore: added build/ to list

* updated build scripts for release line to store

* chore: added helper in to add new field for updater:

* chore: added helper in to add new field for updater:

* chore: updated to add new release flags for updater

* feat: added for simplicity for community, detects OS and builds accordingly

* connected new meta | added end points to the UI meta section

* added meta.installSource to connect detect sourse

* now just passes through meta

* change location

* hold

* feat: store ready update logic

* chore: linux clean up (#169)

* 121 release pipeline improvements (#170)

* MSIX packaging tool included i

* fix: correct script

* windows stop moving your stuff

* removed MSIX to allow for manual packaging (new issue to address)

* fix: snap build calls correct actions | removed test tag

* snap packaging

* Snap Store Live | Windows store next

* cleaned build pipline ready for testing

* Update release.yml

* Update package.json

* Update package.json

* Update release.yml

* Update release.yml

* Update build-win.js

* fix: updated with no publish | changed nodejs version 20->24

* 122 documentation overhaul build updater (#173)

* chore: version bump

* chore: document pass for V3 release

* chore: readme fix

* fix: windows store review

Author: ZFordDev

.github/workflows/release.yml

@@ -0,0 +1,115 @@
+name: SnapDock Release Pipeline
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    #  - 121-release-pipeline-improvements // test branch here
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  # ---------------------------------------------------------
+  # 1. Desktop Installers (Windows + Linux)
+  # ---------------------------------------------------------
+  desktop:
+    name: Desktop Installers
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [windows-latest, ubuntu-latest]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Build Desktop Release
+        run: npm run build:release
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: desktop-${{ matrix.os }}
+          path: |
+            dist/*.exe
+            dist/*.deb
+            dist/*.AppImage
+            dist/*.zip
+            dist/*.dmg
+          if-no-files-found: ignore
+
+# ---------------------------------------------------------
+# 2. Snap Store Build
+# ---------------------------------------------------------
+  snap:
+    name: Snap Store Build
+    runs-on: ubuntu-latest
+    needs: desktop
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Build Store-Safe Version
+        run: npm run build:release:store
+
+      # No script generation — snapcraft.yaml already exists
+
+      - name: Install Snapcraft
+        uses: samuelmeuli/action-snapcraft@v2
+        with:
+          snapcraft_token: ${{ secrets.SNAPCRAFT_LOGIN }}
+
+      - name: Pack Snap
+        run: snapcraft pack
+
+      - name: Upload Snap Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: snap-package
+          path: "*.snap"
+
+      - name: Publish to Snap Store
+        if: startsWith(github.ref, 'refs/tags/')
+        run: snapcraft upload *.snap --release=stable
+
+  # ---------------------------------------------------------
+  # 3. Windows Store Build
+  # ---------------------------------------------------------
+  # cut for futher 
+
+  # ---------------------------------------------------------
+  # 4. GitHub Release
+  # ---------------------------------------------------------
+  release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: [desktop, snap]
+    steps:
+      - name: Download All Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: release-assets/**
+          generate_release_notes: true

.gitignore

@@ -14,6 +14,9 @@ out/
 release/
 *.asar
 *.asar.unpacked
+.env
+build/
+*.snap
 
 # Electron Builder
 electron-builder-cache/

README.md

@@ -106,35 +106,58 @@ cd SnapDock
 # Install dependencies
 npm install
 
-# Build the app
-npm run build
+# Build a development build
+npm run build:dev
 ```
 
-**Windows**
-- `npm install | npm run build`  
+### Windows
+- `npm install | npm run build:dev`  
 - If npm is missing, install Node.js from [https://nodejs.org](https://nodejs.org)
 
-**Linux**
-- `npm install && npm run build`  
+### Linux
+- `npm install && npm run build:dev`  
 - If npm is missing: `sudo apt install npm`
 
-**Dev mode:** Coming soon
+> **Note:** AppImage builds require FUSE on some distros (`sudo apt install libfuse2`).
 
 ---
 
 ## Installation
 
-Most users should install SnapDock using the prebuilt packages available on the Releases page:
+SnapDock is available through official stores for the easiest and most reliable installation experience.
 
-👉 [https://github.com/ZFordDev/SnapDock/releases](https://github.com/ZFordDev/SnapDock/releases)
+### Windows (Recommended)
+Install SnapDock directly from the Microsoft Store:
 
-**Windows**
-- Download the `.exe` installer  
-- Run it  
-- SnapDock is ready to use
+~~👉 **https://apps.microsoft.com/detail/{Placeholder}**~~
 
-**Linux**
-- Download the `.AppImage` or `.deb` package  
+> Windows Store pending review
+
+This provides:
+- Automatic updates  
+- Clean installation & removal  
+- Verified publisher security  
+
+A standalone `.exe` installer is also available on GitHub Releases if preferred.
+
+### Linux (Recommended)
+SnapDock is available on the Snap Store:
+
+👉 **https://snapcraft.io/markdown-workspace**
+
+Install via terminal:
+
+```bash
+sudo snap install markdown-workspace
+```
+
+This provides:
+- Automatic updates  
+- Sandboxed, secure environment  
+- Works across all major distros  
+
+### Manual Linux Packages
+If you prefer manual installation:
 
 **AppImage**
 ```bash
@@ -150,6 +173,11 @@ chmod +x SnapDock-Setup.AppImage
 sudo apt install ./SnapDock-Setup.deb
 ```
 
+### Other Downloads
+All installers and portable builds are available on GitHub Releases:
+
+👉 https://github.com/ZFordDev/SnapDock/releases
+
 No additional runtimes or dependencies are required.
 
 ---
@@ -187,44 +215,61 @@ SnapDock/
 └── temp_notes.md           # Internal notes (not part of the app)
 ```
 
----
-
 ## Roadmap
 
-Planned improvements and upcoming development goals for SnapDock.  
-This list reflects active GitHub issues and near‑term release targets.
+SnapDock’s roadmap reflects active GitHub issues and near‑term development priorities.  
+For the most up‑to‑date list, visit:  
+https://github.com/ZFordDev/SnapDock/issues
+
+### Core Improvements
+- **[Diff Viewer](ca://s?q=Open_Diff_Viewer_issue)**  
+  _Side‑by‑side diffing for Markdown documents_  
+  (#154)
+
+- **[Markdown Page Break Syntax for PDF Export](ca://s?q=Open_Page_Break_issue)**  
+  _Support for `---` or `\page` to control PDF pagination_  
+  (#153)
+
+- **[Find Box (Ctrl+F Search)](ca://s?q=Open_Find_Box_issue)**  
+  _Inline search within the editor_  
+  (#152)
+
+- **[Word Count for Selected Text](ca://s?q=Open_Selected_Word_Count_issue)**  
+  _Granular writing metrics_  
+  (#151)
+
+### UI / UX Enhancements
+- **[Unlock Native Right‑Click Context Menu](ca://s?q=Open_Context_Menu_issue)**  
+  _Restore OS‑native context menus for better usability_  
+  (#150)
+
+- **[Editor Status Bar Metrics](ca://s?q=Open_Status_Bar_issue)**  
+  _Live stats: words, characters, cursor position_  
+  (#149)
 
-### **In Progress / High Priority**
-- [X] **Ecosystem Standards Migration**  
-  _Documentation improvements and alignment with ZFordDev ecosystem standards_  
-  (#109)
+- **[Document Outline Panel](ca://s?q=Open_Outline_Panel_issue)**  
+  _Heading‑based navigation sidebar_  
+  (#148)
 
-- [ ] **Integrate New Updater Logic**  
-  _Modernized update pipeline for V3 and future releases_  
-  (#104)
+### Markdown Engine & Plugin Pipeline
+- **[Fix markdown‑it‑link‑attributes Wiring](ca://s?q=Open_Link_Attributes_issue)**  
+  (#135)
 
-### **UI / UX Improvements**
-- [X] **Replace Electron Frame With Custom SnapDock Frame**  
-  _Cleaner, native-feeling window chrome_  
-  (#95)
+- **[Fix markdown‑it‑emoji Wiring](ca://s?q=Open_Emoji_issue)**  
+  (#134)
 
-- [X] **Add Tab Overflow Scrolling / Horizontal Scroll**  
-  _Improves usability for large workspaces_  
-  (#87)
+- **[Fix markdown‑it‑container Wiring](ca://s?q=Open_Container_issue)**  
+  (#133)
 
-### **Platform Releases**
-- [ ] **Windows Store Release**  
-  _Submission + certification for Microsoft Store_
+- **[Markdown‑it Plugin Wiring Fix (Renderer Pipeline)](ca://s?q=Open_Renderer_Pipeline_issue)**  
+  (#132)
 
-- [ ] **Snap Store Release**  
-  _Snapcraft packaging + publishing_
+### Build, Release & Automation
+- **[Improve Versioning Discipline & Release Automation](ca://s?q=Open_Release_Automation_issue)**  
+  (#139)
 
-### **Upcoming (V3 Cycle)**
-- [ ] New developer mode (`npm run dev`)
-- [ ] Theme engine improvements + custom theme support
-- [ ] Enhanced PDF export pipeline
-- [ ] V3 UI/UX redesign
-- [ ] Import custom `.sdwp` files as virtual workspaces
+- **[Improve Build Scripts & Build‑Type Workflow](ca://s?q=Open_Build_Scripts_issue)**  
+  (#138)
 
 ---