feat(windows): implement Windows install via PowerShell shortcut

Generates a PowerShell script that downloads the icon, wraps it as an
.ico, configures the Firefox FTWA profile when relevant, and creates a
Start Menu .lnk shortcut pointing at the browser with the right app
arguments. Enables Windows in the OS picker and routes /u and /v
requests through the new template.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: mathix420

README.md

@@ -32,7 +32,7 @@ When choosing linux as target OS, FTWA generate a shell script that will create
 
 ### On Windows
 
-TODO: Not implemented yet. But will use shortcuts.
+FTWA generates a PowerShell script that downloads the icon, wraps it as an `.ico`, and creates a Start Menu `.lnk` shortcut (via `WScript.Shell`) pointing at the browser executable with the right `--app=` / Firefox profile arguments. The shortcut shows up in Start Menu search.
 
 ### On Macos
 

app/app.vue

@@ -49,7 +49,7 @@ onMounted(() => {
     path: "",
   }));
   targetInfos.value.bw = getUserBrowser(["safari"]);
-  targetInfos.value.os = getUserOS(["windows"]);
+  targetInfos.value.os = getUserOS([]);
 });
 
 useSeoMeta({

app/components/AppUnchainer.vue

@@ -53,8 +53,7 @@ async function submitWebsite() {
     });
     if (data.value?.uid) {
       websiteId.value = data.value.uid;
-      const installUrl = getInstallURL({ id: data.value.uid }, false);
-      execCode.value = `sh -ec "$(curl -fsSL '${installUrl}')"`;
+      execCode.value = getInstallCommand({ id: data.value.uid }, false);
     }
     submitLoading.value = false;
   }

app/composables/copyCode.ts

@@ -3,8 +3,7 @@ import type { VerifiedWebsiteType } from "~~/types";
 export function copyCode(website: VerifiedWebsiteType) {
   const { copy } = useCopyToClipboard();
 
-  const installURL = getInstallURL(website);
-  const code = `sh -ec "$(curl -fsSL '${installURL}')"`;
+  const code = getInstallCommand(website);
 
   useRouter().replace({ hash: "#" });
 

app/composables/getInstalURL.ts

@@ -9,3 +9,13 @@ export function getInstallURL(website: Pick<VerifiedWebsiteType, "id">, verified
     + `&bw=${targetInfos.value.bw}`
     + `&path=${encodeURIComponent(targetInfos.value.path)}`;
 }
+
+export function getInstallCommand(website: Pick<VerifiedWebsiteType, "id">, verified = true): string {
+  const targetInfos = useState<TargetInfos>("target-infos");
+  const url = getInstallURL(website, verified);
+
+  if (targetInfos.value.os === "windows") {
+    return `powershell -NoProfile -Command "iex ((New-Object Net.WebClient).DownloadString('${url}'))"`;
+  }
+  return `sh -ec "$(curl -fsSL '${url}')"`;
+}

app/settings.ts

@@ -31,9 +31,8 @@ export const operatingSystems: OperatingSystem[] = [{
   label: "macOS",
   icon: "simple-icons:apple",
 }, {
-  disabled: true,
   value: "windows",
-  label: "Windows (to be implemented)",
+  label: "Windows",
   icon: "simple-icons:windows",
 }];
 
@@ -85,7 +84,7 @@ export const browsers: TBrowser[] = [{
 }, {
   disabled: true,
   value: "safari",
-  label: "Safari (to be implemented)",
+  label: "Safari (cannot be implemented)",
   defaultExecutablePath: {
     linux: null,
     macos: "/Applications/Safari.app/Contents/MacOS/Safari",

server/routes/u/[uid].get.ts

@@ -11,7 +11,7 @@ export default defineEventHandler(async (event) => {
     return "echo '\nERROR: Missing target infos.'";
   }
 
-  if (["windows"].includes(target.os) || ["safari"].includes(target.bw)) {
+  if (["safari"].includes(target.bw)) {
     return "echo '\nERROR: Target unsupported (yet).'";
   }
 

server/routes/v/[uid].get.ts

@@ -11,7 +11,7 @@ export default defineEventHandler(async (event) => {
     return "echo '\nERROR: Missing target infos.'";
   }
 
-  if (["windows"].includes(target.os) || ["safari"].includes(target.bw)) {
+  if (["safari"].includes(target.bw)) {
     return "echo '\nERROR: Target unsupported (yet).'";
   }
 

server/templates/windows.ts

@@ -1,13 +1,105 @@
+import userChromeCss from "./files/userChrome.css";
+import userJs from "./files/user.js.txt";
 import type { TargetInfos, WebsiteType } from "~~/types";
 
+function psQuote(s: string): string {
+  return s.replace(/'/g, "''");
+}
+
+function firefoxSetup(target: TargetInfos): string {
+  if (target.bw !== "firefox") return "# Firefox setup skipped";
+
+  return `Write-Host "\nSetting up Firefox..."
+Start-Process -FilePath '${psQuote(target.path)}' -ArgumentList '-CreateProfile','FTWA' -Wait -NoNewWindow
+
+$ProfileBase = Join-Path $env:APPDATA 'Mozilla\\Firefox\\Profiles'
+$ProfileFolder = Get-ChildItem -Path $ProfileBase -Directory -Filter '*.FTWA' | Select-Object -First 1 -ExpandProperty FullName
+if (-not $ProfileFolder) { throw 'FTWA Firefox profile not found.' }
+
+$ChromeDir = Join-Path $ProfileFolder 'chrome'
+New-Item -ItemType Directory -Force -Path $ChromeDir | Out-Null
+
+@'
+${userChromeCss}
+'@ | Set-Content -Path (Join-Path $ChromeDir 'userChrome.css') -Encoding UTF8
+
+@'
+${userJs}
+'@ | Set-Content -Path (Join-Path $ProfileFolder 'user.js') -Encoding UTF8
+
+Write-Host "Firefox setup done."`;
+}
+
 export function windows({
   website,
   target,
 }: {
   website: WebsiteType;
   target: TargetInfos;
 }) {
-  // TODO: https://github.com/nwutils/create-desktop-shortcuts/blob/main/src/windows.vbs
+  const safeName = website.name.replace(/[\\/:*?"<>|]/g, "");
+  const fname = "ftwa-" + website.name.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+
+  let commandArgs = "";
+  if (target.bw === "firefox") {
+    commandArgs = `--no-remote -P "FTWA" "${website.url}"`;
+  } else if (["chrome", "opera", "brave", "edge"].includes(target.bw)) {
+    commandArgs = `--app=${website.url}`;
+  }
+
+  return `# Generated by FTWA (https://ftwa.mathix.dev)
+# /u/ links are only available for 24h
+# Check the app store for more apps: https://ftwa.mathix.dev/store
+
+$ErrorActionPreference = 'Stop'
+
+${firefoxSetup(target)}
+
+Write-Host "\nCreating shortcut..."
+
+$IconDir = Join-Path $env:LOCALAPPDATA 'FTWA\\icons'
+New-Item -ItemType Directory -Force -Path $IconDir | Out-Null
+
+$PngPath = Join-Path $IconDir '${fname}.png'
+$IcoPath = Join-Path $IconDir '${fname}.ico'
+
+Invoke-WebRequest -Uri '${website.logo}' -OutFile $PngPath -UseBasicParsing
+
+# Wrap the PNG as a single-image ICO so Windows can use any size (incl. 256+)
+Add-Type -AssemblyName System.Drawing
+$Bmp = [System.Drawing.Bitmap]::FromFile($PngPath)
+$IcoW = if ($Bmp.Width -ge 256) { [byte]0 } else { [byte]$Bmp.Width }
+$IcoH = if ($Bmp.Height -ge 256) { [byte]0 } else { [byte]$Bmp.Height }
+$Bmp.Dispose()
+
+$PngBytes = [System.IO.File]::ReadAllBytes($PngPath)
+$Ms = New-Object System.IO.MemoryStream
+$Bw = New-Object System.IO.BinaryWriter($Ms)
+$Bw.Write([uint16]0); $Bw.Write([uint16]1); $Bw.Write([uint16]1)
+$Bw.Write($IcoW); $Bw.Write($IcoH); $Bw.Write([byte]0); $Bw.Write([byte]0)
+$Bw.Write([uint16]1); $Bw.Write([uint16]32)
+$Bw.Write([uint32]$PngBytes.Length); $Bw.Write([uint32]22)
+$Bw.Write($PngBytes)
+$Bw.Close()
+[System.IO.File]::WriteAllBytes($IcoPath, $Ms.ToArray())
+$Ms.Dispose()
+
+$BrowserPath = '${psQuote(target.path)}'
+if (-not (Test-Path $BrowserPath)) { throw "Browser not found: $BrowserPath" }
+
+$ShortcutDir = [Environment]::GetFolderPath('Programs')
+$ShortcutPath = Join-Path $ShortcutDir '${psQuote(safeName)}.lnk'
+
+$WshShell = New-Object -ComObject WScript.Shell
+$Shortcut = $WshShell.CreateShortcut($ShortcutPath)
+$Shortcut.TargetPath = $BrowserPath
+$Shortcut.Arguments = '${psQuote(commandArgs)}'
+$Shortcut.IconLocation = $IcoPath
+$Shortcut.Description = 'Generated by FTWA (https://ftwa.mathix.dev)'
+$Shortcut.WorkingDirectory = (Split-Path $BrowserPath -Parent)
+$Shortcut.Save()
 
-  return "";
+Write-Host "Shortcut created: $ShortcutPath"
+Write-Host "Search for '${psQuote(website.name)}' in the Start Menu."
+`;
 }