cross platform installers: windows powershell plus macos and every linux distro

README.md

@@ -62,22 +62,32 @@ This repo eats its own cooking. Everything you see on the website is styled by t
 
 The site is live. No setup, no build, nothing to install: https://dssl-sable.vercel.app
 
-Want the engine on your own page? Two tags:
+Want the engine on your own page? One line per platform.
 
-```html
-<script type="module" src="/dssl/boot.js"></script>
-<link rel="stylesheet/dssl" href="/styles/tokens.dssl">
+macOS or Linux (any distro, bash not required):
+
+```sh
+curl -fsSL https://dssl-sable.vercel.app/install.sh | sh
 ```
 
-Every `<link rel="stylesheet/dssl">` on the page gets fetched and applied automatically, and the engine keeps restyling the DOM live as elements come and go. That is the whole install.
+Windows (PowerShell 5.1 or newer, no admin rights):
 
-Or grab it from a terminal:
+```powershell
+irm https://dssl-sable.vercel.app/install.ps1 | iex
+```
 
-```sh
-curl -fsSL https://dssl-sable.vercel.app/install.sh | sh
+Both drop a `dssl-engine/` folder next to you: the engine, a starter token set, a tiny example stylesheet and a usage guide. The sh one is a POSIX script. It downloads with curl or wget, whichever you have, and unpacks with tar, which every distro and macOS already ship. If tar is missing it falls back to unzip, then python3. Want it somewhere specific? Append a folder: `... | sh -s -- ~/my-site`.
+
+Prefer to click: [dssl-engine.zip](https://dssl-sable.vercel.app/dssl-engine.zip) or [dssl-engine.tar.gz](https://dssl-sable.vercel.app/dssl-engine.tar.gz). Same package, straight from the browser.
+
+Then wire it into a page with two tags:
+
+```html
+<script type="module" src="/dssl/boot.js"></script>
+<link rel="stylesheet/dssl" href="/styles/tokens.dssl">
 ```
 
-That drops a `dssl-engine/` folder with the engine, a starter token set, a tiny example stylesheet and a usage guide (also in `package/` in this repo). Plain zip if you prefer: https://dssl-sable.vercel.app/dssl-engine.zip
+Every `<link rel="stylesheet/dssl">` on the page gets fetched and applied automatically, and the engine keeps restyling the DOM live as elements come and go. That is the whole install. The package's USAGE.md covers the same ground in two minutes, and the source files also live in `package/` in this repo.
 
 Clone this repo if you want to read the engine. Everything runs in the browser.
 
@@ -85,6 +95,7 @@ Clone this repo if you want to read the engine. Everything runs in the browser.
 
 - `public/dssl/` the engine: parser, resolver, boot
 - `public/styles/` the styles that drive the site
+- `package/` what ships in the download: engine, starter files, usage guide, installers
 - `src/` the Next.js site
 - `scripts/` smoke tests for the engine
 

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EHS-Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/USAGE.md

@@ -1,16 +1,32 @@
-# DSSL engine — quickstart
+# DSSL engine quickstart
 
 DSSL is a style language that runs in the browser. You write `.dssl` files, add two tags to your page, and the engine does the rest. No compiler, no build step, no CSS output. The engine walks your DOM live and writes styles straight onto the elements it matches, including elements that show up later.
 
 ## 1. Get the engine
 
-Copy the `dssl/` folder from this package into your project, or grab it fresh from a terminal:
+Pick your platform. All three routes land the same thing: a `dssl-engine/` folder with the engine, a starter token set, an example stylesheet and this guide.
+
+macOS or Linux (any distro, bash not required):
 
 ```sh
 curl -fsSL https://dssl-sable.vercel.app/install.sh | sh
 ```
 
-That drops a `dssl-engine/` folder next to you with everything you need.
+The installer runs with plain sh (dash, ash and busybox are fine), downloads with curl or wget, whichever you have, and unpacks with tar, which every distro and macOS ship by default. If tar is somehow missing it falls back to unzip, then to python3.
+
+Windows (PowerShell 5.1 or newer, no admin rights):
+
+```powershell
+irm https://dssl-sable.vercel.app/install.ps1 | iex
+```
+
+No terminal at all? Download the package straight from the browser: [dssl-engine.zip](https://dssl-sable.vercel.app/dssl-engine.zip) or [dssl-engine.tar.gz](https://dssl-sable.vercel.app/dssl-engine.tar.gz), and unzip it anywhere.
+
+To install into a specific folder, append it as an argument:
+
+```sh
+curl -fsSL https://dssl-sable.vercel.app/install.sh | sh -s -- ~/my-site
+```
 
 ## 2. Wire it up
 
@@ -87,6 +103,8 @@ gives one subtree its own engine, its own tokens and its own cascade. The playgr
 - `dssl/` the engine. `boot.js` is the entry, `index.js` the public API.
 - `styles/tokens.dssl` the starter token set (colors, fonts, radii, shadows)
 - `examples/hello.dssl` a tiny starter stylesheet
+- `install.sh` the macOS and Linux installer, same one the one-liner pipes
+- `install.ps1` the Windows installer
 - `USAGE.md` this file
 - `LICENSE` MIT
 

package/install.ps1

@@ -0,0 +1,30 @@
+# DSSL installer for Windows. PowerShell 5.1 or newer, no admin rights needed.
+#
+#   irm https://dssl-sable.vercel.app/install.ps1 | iex
+#
+# Drops a dssl-engine folder into your current directory.
+
+$ErrorActionPreference = "Stop"
+
+$Base = "https://dssl-sable.vercel.app"
+$Dest = Join-Path (Get-Location).Path "dssl-engine"
+
+# some Windows PowerShell 5.1 installs still default to ancient TLS; be explicit
+try { [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 } catch {}
+
+Write-Host "fetching the DSSL engine..."
+$Zip = Join-Path ([IO.Path]::GetTempPath()) "dssl-engine.zip"
+Invoke-WebRequest -Uri "$Base/dssl-engine.zip" -OutFile $Zip -UseBasicParsing
+
+if (Test-Path $Dest) { Remove-Item -Recurse -Force $Dest }
+
+$Stage = Join-Path ([IO.Path]::GetTempPath()) ("dssl-unpack-" + [Guid]::NewGuid().ToString("N").Substring(0, 8))
+Expand-Archive -Path $Zip -DestinationPath $Stage -Force
+Move-Item -Path (Join-Path $Stage "dssl-engine") -Destination $Dest -Force
+Remove-Item -Recurse -Force $Stage
+Remove-Item -Force $Zip
+
+Write-Host ""
+Write-Host "DSSL engine installed to $Dest"
+Write-Host ""
+Write-Host "next: open USAGE.md in that folder. It is two tags and one example file."

package/install.sh

@@ -1,19 +1,78 @@
 #!/bin/sh
-# DSSL engine installer
+# DSSL installer. macOS, Linux, the BSDs, busybox: anything with a POSIX shell.
+#
 #   curl -fsSL https://dssl-sable.vercel.app/install.sh | sh
-set -e
+#
+# wget works just as well:
+#   wget -qO- https://dssl-sable.vercel.app/install.sh | sh
+#
+# install somewhere else by appending a folder:
+#   curl -fsSL https://dssl-sable.vercel.app/install.sh | sh -s -- ~/my-site
+set -eu
+
 BASE="https://dssl-sable.vercel.app"
-ZIP="/tmp/dssl-engine-$$.zip"
+DEST="${1:-.}"
+
+fetch() {
+  # fetch <url> <file>. curl first, wget second, an honest no otherwise.
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$1" -o "$2"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$2" "$1"
+  else
+    echo "dssl installer: I need 'curl' or 'wget' to download the engine. Install either one and run this again." >&2
+    exit 1
+  fi
+}
 
-command -v curl >/dev/null 2>&1 || { echo "DSSL installer: 'curl' is required."; exit 1; }
-command -v unzip >/dev/null 2>&1 || { echo "DSSL installer: 'unzip' is required."; exit 1; }
+unpack() {
+  # unpack <archive> <where>. tar.gz is the default package and tar ships
+  # with every distro and macOS. No tar? Take the zip route via unzip,
+  # or python3 if even unzip is missing.
+  archive="$1"
+  where="$2"
+  case "$archive" in
+    *.tar.gz)
+      tar -xzf "$archive" -C "$where"
+      ;;
+    *.zip)
+      if command -v unzip >/dev/null 2>&1; then
+        unzip -q "$archive" -d "$where"
+      elif command -v python3 >/dev/null 2>&1; then
+        python3 -c "import sys, zipfile; zipfile.ZipFile(sys.argv[1]).extractall(sys.argv[2])" "$archive" "$where"
+      else
+        echo "dssl installer: no tar, no unzip, no python3. One of the three, please." >&2
+        exit 1
+      fi
+      ;;
+  esac
+}
+
+# a scratch dir, gone when we are
+TMP="$(mktemp -d 2>/dev/null || echo "${TMPDIR:-/tmp}/dssl-install-$$")"
+mkdir -p "$TMP"
+trap 'rm -rf "$TMP"' EXIT INT TERM
 
 echo "fetching the DSSL engine..."
-curl -fsSL "$BASE/dssl-engine.zip" -o "$ZIP"
-rm -rf dssl-engine
-unzip -q "$ZIP" -d .
-rm -f "$ZIP"
 
+if command -v tar >/dev/null 2>&1; then
+  fetch "$BASE/dssl-engine.tar.gz" "$TMP/engine.tar.gz"
+  unpack "$TMP/engine.tar.gz" "$TMP"
+else
+  fetch "$BASE/dssl-engine.zip" "$TMP/engine.zip"
+  unpack "$TMP/engine.zip" "$TMP"
+fi
+
+if [ ! -d "$TMP/dssl-engine" ]; then
+  echo "dssl installer: the package came down in an unexpected shape. Grab it manually: $BASE/dssl-engine.zip" >&2
+  exit 1
+fi
+
+mkdir -p "$DEST"
+rm -rf "$DEST/dssl-engine"
+cp -R "$TMP/dssl-engine" "$DEST/dssl-engine"
+
+echo ""
+echo "DSSL engine installed to $DEST/dssl-engine"
 echo ""
-echo "DSSL engine installed to ./dssl-engine"
-echo "read dssl-engine/USAGE.md to wire it into a page."
+echo "next: open dssl-engine/USAGE.md. It is two tags and one example file."

package/styles/tokens.dssl

@@ -0,0 +1,122 @@
+// =========================================================================
+// tokens.dssl — DSSL's own design tokens
+// v0.3.3 "The Classic Edition": a print-era look — parchment paper, ink,
+// oxblood accent, serif display type, squared corners, hairline rules.
+// The dark palette lives in a behavior and is `use`d by both the system
+// preference and the manual theme signal — define once, apply twice.
+// =========================================================================
+
+tokens {
+  font {
+    serif: "Charter", "Iowan Old Style", "Palatino Linotype", "Palatino", "Georgia", "Times New Roman", serif
+    sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif
+    mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace
+  }
+  color {
+    paper: #f5f0e4
+    card: #fdfaf2
+    ink: #26201a
+    muted: #6f6250
+    line: #ddd2bc
+    accent: #7c2d2d
+    accent-ink: #f9efdd
+    ok: #3d6b46
+    err: #a83226
+    code-bg: #ece4cf
+    code-ink: #2b2318
+    code-line: #d8cbac
+    code-key: #8e3b1f
+    code-sel: #38614f
+    code-prop: #35566e
+    code-str: #6f5a22
+    code-num: #6e3b52
+    code-com: #6f6350
+  }
+  radius {
+    sm: 2
+    md: 4
+    lg: 6
+    xl: 8
+    full: 999
+  }
+  shadow {
+    sm: 0 1 2 color.ink/12
+    md: 0 2 6 color.ink/14
+    lg: 0 6 18 color.ink/16
+  }
+}
+
+// ---- dark palette (shared) ---------------------------------------------
+// classic dark = a candlelit study: deep walnut, parchment text, brass accent
+
+behavior palette-dark {
+  tokens {
+    font {
+      serif: "Charter", "Iowan Old Style", "Palatino Linotype", "Palatino", "Georgia", "Times New Roman", serif
+      sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif
+      mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace
+    }
+    color {
+      paper: #181310
+      card: #221b15
+      ink: #ece2cd
+      muted: #a5937a
+      line: #372d21
+      accent: #c98d52
+      accent-ink: #241402
+      ok: #7fae8a
+      err: #d97e6c
+      code-bg: #120e0b
+      code-ink: #e5d9bd
+      code-line: #2e261c
+      code-key: #d99a62
+      code-sel: #8fb8a2
+      code-prop: #92b4cc
+      code-str: #c9b47c
+      code-num: #c9a0b4
+      code-com: #94856a
+    }
+  }
+}
+
+@media (prefers-color-scheme: dark) {
+  use palette-dark
+}
+
+@signal theme == dark {
+  use palette-dark
+}
+
+@signal theme == light {
+  use palette-light
+}
+
+behavior palette-light {
+  tokens {
+    font {
+      serif: "Charter", "Iowan Old Style", "Palatino Linotype", "Palatino", "Georgia", "Times New Roman", serif
+      sans: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif
+      mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace
+    }
+    color {
+      paper: #f5f0e4
+      card: #fdfaf2
+      ink: #26201a
+      muted: #6f6250
+      line: #ddd2bc
+      accent: #7c2d2d
+      accent-ink: #f9efdd
+      ok: #3d6b46
+      err: #a83226
+      code-bg: #ece4cf
+      code-ink: #2b2318
+      code-line: #d8cbac
+      code-key: #8e3b1f
+      code-sel: #38614f
+      code-prop: #35566e
+      code-str: #6f5a22
+      code-num: #6e3b52
+      code-com: #6f6350
+    }
+  }
+}

public/install.sh

@@ -0,0 +1,78 @@
+#!/bin/sh
+# DSSL installer. macOS, Linux, the BSDs, busybox: anything with a POSIX shell.
+#
+#   curl -fsSL https://dssl-sable.vercel.app/install.sh | sh
+#
+# wget works just as well:
+#   wget -qO- https://dssl-sable.vercel.app/install.sh | sh
+#
+# install somewhere else by appending a folder:
+#   curl -fsSL https://dssl-sable.vercel.app/install.sh | sh -s -- ~/my-site
+set -eu
+
+BASE="https://dssl-sable.vercel.app"
+DEST="${1:-.}"
+
+fetch() {
+  # fetch <url> <file>. curl first, wget second, an honest no otherwise.
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$1" -o "$2"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$2" "$1"
+  else
+    echo "dssl installer: I need 'curl' or 'wget' to download the engine. Install either one and run this again." >&2
+    exit 1
+  fi
+}
+
+unpack() {
+  # unpack <archive> <where>. tar.gz is the default package and tar ships
+  # with every distro and macOS. No tar? Take the zip route via unzip,
+  # or python3 if even unzip is missing.
+  archive="$1"
+  where="$2"
+  case "$archive" in
+    *.tar.gz)
+      tar -xzf "$archive" -C "$where"
+      ;;
+    *.zip)
+      if command -v unzip >/dev/null 2>&1; then
+        unzip -q "$archive" -d "$where"
+      elif command -v python3 >/dev/null 2>&1; then
+        python3 -c "import sys, zipfile; zipfile.ZipFile(sys.argv[1]).extractall(sys.argv[2])" "$archive" "$where"
+      else
+        echo "dssl installer: no tar, no unzip, no python3. One of the three, please." >&2
+        exit 1
+      fi
+      ;;
+  esac
+}
+
+# a scratch dir, gone when we are
+TMP="$(mktemp -d 2>/dev/null || echo "${TMPDIR:-/tmp}/dssl-install-$$")"
+mkdir -p "$TMP"
+trap 'rm -rf "$TMP"' EXIT INT TERM
+
+echo "fetching the DSSL engine..."
+
+if command -v tar >/dev/null 2>&1; then
+  fetch "$BASE/dssl-engine.tar.gz" "$TMP/engine.tar.gz"
+  unpack "$TMP/engine.tar.gz" "$TMP"
+else
+  fetch "$BASE/dssl-engine.zip" "$TMP/engine.zip"
+  unpack "$TMP/engine.zip" "$TMP"
+fi
+
+if [ ! -d "$TMP/dssl-engine" ]; then
+  echo "dssl installer: the package came down in an unexpected shape. Grab it manually: $BASE/dssl-engine.zip" >&2
+  exit 1
+fi
+
+mkdir -p "$DEST"
+rm -rf "$DEST/dssl-engine"
+cp -R "$TMP/dssl-engine" "$DEST/dssl-engine"
+
+echo ""
+echo "DSSL engine installed to $DEST/dssl-engine"
+echo ""
+echo "next: open dssl-engine/USAGE.md. It is two tags and one example file."