Integrate Store packaging, agent editing, translations and shared-settings sync

.github/workflows/ci.yml

@@ -60,6 +60,19 @@ jobs:
       - name: Run unit tests
         run: npm test
 
+      # The Store package only builds on Windows (makeappx), so check it here,
+      # with a placeholder identity in place of the Partner Center one.
+      - name: Build Microsoft Store package
+        if: runner.os == 'Windows'
+        run: npm run package:windows:store:test
+
+      - uses: actions/upload-artifact@v4
+        if: runner.os == 'Windows'
+        with:
+          name: microsoft-store-test-package
+          path: releases/*.appx
+          if-no-files-found: error
+
       # The installer runs the Chocolatey helper, and Update now its elevated
       # script, with Windows PowerShell 5.1, not the pwsh that npm test finds,
       # so check them there too.

.github/workflows/release.yml

@@ -97,6 +97,19 @@ jobs:
           path: releases/*.exe
           if-no-files-found: error
 
+      # Built from the same stamped checkout, unsigned: Partner Center signs it.
+      # It is uploaded to Partner Center by hand, not attached to the release
+      # (docs/windows/MICROSOFT_STORE_RELEASE.md). Skipped until
+      # packaging/windows/store/identity.json is filled in.
+      - name: Package Microsoft Store .appx
+        run: node scripts/package-windows-store.js --if-configured
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: microsoft-store-package
+          path: releases/*.appx
+          if-no-files-found: ignore
+
 
   build-linux:
     needs: authorize-release

README.md

@@ -114,15 +114,19 @@ page and hands you a link to send. It's usually online in under a minute.
 
 | Platform | Recommended | Guide |
 | --- | --- | --- |
-| **Windows 10 / 11** (64-bit) | Chocolatey, or the `.exe` (which can set up Chocolatey updates for you) | [Chocolatey](docs/windows/chocolatey.md) · [Windows](docs/windows_installation.md) |
+| **Windows 10 / 11** (64-bit) | Microsoft Store, Chocolatey, or the `.exe` | [Microsoft Store](docs/windows/microsoft-store.md) · [Chocolatey](docs/windows/chocolatey.md) · [Windows](docs/windows_installation.md) |
 | **Ubuntu 26.04** | APT repository | [Ubuntu](docs/linux/apt.md) |
 | **Fedora 44 Workstation** | DNF repository | [Fedora](docs/linux/dnf.md) |
 | **Other Linux** | Portable `.tar.gz` | [Linux overview](docs/linux/linux_install.md) |
 
 Every build is also on the [Releases page](https://github.com/Twest2/StepForge/releases/latest).
-Installing through Chocolatey, APT or DNF keeps StepForge up to date with the
-rest of your system, and on Windows **Settings → About → Update now** installs
-a new version in one click.
+The Microsoft Store updates StepForge automatically. Installing through
+Chocolatey, APT or DNF keeps StepForge up to date with the rest of your system,
+and with Chocolatey, **Settings → About → Update now** installs a new version
+in one click.
+
+**Windows:** open [StepForge in the Microsoft Store](https://apps.microsoft.com/search?query=StepForge)
+and click **Get**.
 
 <details>
 <summary><strong>Windows (Chocolatey)</strong> commands</summary>
@@ -219,6 +223,10 @@ was recorded with StepForge.
 - **Publish to Confluence** (beta) on Confluence Cloud or your organization's
   Data Center site, including sites that need a smart card (CAC).
 - **Publish to Wiki.js** (beta), with the screenshots uploaded to the wiki.
+- **Six languages.** English, plus French, Spanish, Russian, Simplified
+  Chinese and Japanese (beta). StepForge follows your system language, or
+  pick one in **Settings → General → Language**. Exported guides stay in
+  English.
 
 **Optional, and off until you turn them on**
 
@@ -258,7 +266,7 @@ each optional feature sends.
 
 **Installing**
 
-- [Windows installer](docs/windows_installation.md) · [Chocolatey](docs/windows/chocolatey.md)
+- [Microsoft Store](docs/windows/microsoft-store.md) · [Windows installer](docs/windows_installation.md) · [Chocolatey](docs/windows/chocolatey.md)
 - [Linux overview](docs/linux/linux_install.md) · [Ubuntu](docs/linux/apt.md) · [Fedora](docs/linux/dnf.md)
 
 **Contributing**

app/cloud-account.js

@@ -348,6 +348,7 @@ class CloudAccount {
 
   listVersions() { return this.storage.listVersions(); }
   listDeletions() { return this.storage.listDeletions(); }
+  listSettings() { return this.storage.listSettings(); }
   listParts() { return this.storage.listParts(); }
   upload(file) { return this.storage.upload(file); }
   download(id, options) { return this.storage.download(id, options); }

app/data-dir.js

@@ -4,25 +4,39 @@ const os = require('node:os');
 const path = require('node:path');
 const { LibraryLocation } = require('../core/library-location');
 
-/** The default library folder: STEPFORGE_DATA_DIR, else the per-user data folder. */
-function resolveDataDir() {
+/**
+ * The default library folder: STEPFORGE_DATA_DIR, else StepForge in the home
+ * folder on Windows (%USERPROFILE%\StepForge), else the per-user data folder.
+ *
+ * Windows used to keep it in %APPDATA%\stepforge. That folder doesn't survive
+ * uninstalling the Microsoft Store app (Windows deletes what a Store app
+ * writes under %APPDATA%), it is also Electron's profile, and every install
+ * type now shares one location. Not Documents: OneDrive, Dropbox and Google
+ * Drive often back it up, which would upload every guide and fight StepForge's
+ * own sync. A library in the old folder moves automatically (LibraryLocation).
+ */
+function resolveDataDir({ homeDir = os.homedir() } = {}) {
   if (process.env.STEPFORGE_DATA_DIR) return process.env.STEPFORGE_DATA_DIR;
-  if (process.platform === 'win32') {
-    return path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'stepforge');
-  }
-  const xdg = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');
+  if (process.platform === 'win32') return path.join(homeDir, 'StepForge');
+  const xdg = process.env.XDG_DATA_HOME || path.join(homeDir, '.local', 'share');
   return path.join(xdg, 'stepforge');
 }
 
+/** The old Windows default, which LibraryLocation moves libraries out of. */
+function legacyWindowsDataDir(env = process.env, homeDir = os.homedir()) {
+  return path.join(env.APPDATA || path.join(homeDir, 'AppData', 'Roaming'), 'stepforge');
+}
+
 /** The library-location bookkeeping the app keeps in Electron's userData folder. */
-function libraryLocationFor(userDataDir) {
+function libraryLocationFor(userDataDir, { homeDir } = {}) {
   return new LibraryLocation({
     // Keep this bootstrap setting outside the movable library so a selected
     // destination can be resolved before the store is opened.
     file: path.join(userDataDir, 'library-location.json'),
-    defaultPath: resolveDataDir(),
+    defaultPath: resolveDataDir({ homeDir }),
+    legacyPath: process.platform === 'win32' ? legacyWindowsDataDir(process.env, homeDir) : null,
     override: process.env.STEPFORGE_DATA_DIR || null,
   });
 }
 
-module.exports = { resolveDataDir, libraryLocationFor };
+module.exports = { resolveDataDir, legacyWindowsDataDir, libraryLocationFor };

app/google-drive.js

@@ -394,6 +394,11 @@ class GoogleDrive {
     return this.listAppData("trashed = false and appProperties has { key='stepforge' and value='deletion-v1' }");
   }
 
+  // Global placeholders, branding and language (see core/shared-settings.js).
+  async listSettings() {
+    return this.listAppData("trashed = false and appProperties has { key='stepforge' and value='settings-v1' }");
+  }
+
   // Files shared between versions (see core/cloud-parts.js).
   async listParts() {
     return this.listAppData("trashed = false and appProperties has { key='stepforge' and value='part-v1' }");