Hermes-Setup.exe is a small signed Rust+Tauri binary that drives
scripts/install.ps1 stage-by-stage with a native UI matching the
desktop's design language. Replaces the chicken-and-egg pattern of
shipping a 200MB Electron app whose first launch existed only to
run install.ps1.
The architecture:
Rust backend (src-tauri/):
bootstrap.rs orchestrator -- Tauri commands, stage iteration
install_script.rs resolve install.ps1 (dev checkout, cache, GitHub raw)
powershell.rs spawn powershell, line-stream stdout/stderr, parse JSON
events.rs BootstrapEvent types -- mirror bootstrap-runner.cjs
paths.rs HERMES_HOME resolution + tracing log setup
build.rs bakes BUILD_PIN_COMMIT / BUILD_PIN_BRANCH from
'git rev-parse HEAD' at compile time
React frontend (src/):
Tauri webview rendering 4 screens (welcome / progress / success /
failure), driven by nanostores subscribing to the Rust event stream.
Visual layer reuses the desktop's styles.css wholesale via @import
so the installer and desktop never drift visually.
Distribution:
targets = ['app', 'dmg', 'appimage'] -- no NSIS/MSI wrapper. The
raw target/release/Hermes-Setup.exe IS the artifact on Windows;
.dmg + .app on macOS; AppImage on Linux. One file, double-click,
no installer-installing-an-installer pattern.
Compile-time pinning:
build.rs reads 'git rev-parse HEAD' and emits
cargo:rustc-env=BUILD_PIN_COMMIT=<sha> + BUILD_PIN_BRANCH=<branch>.
bootstrap.rs's option_env!() picks these up so the binary fetches
install.ps1 from the exact SHA it was tested against. CI / release
builds can override via HERMES_BUILD_PIN_COMMIT env var.
Windows manifest:
hermes-setup.manifest declares level='asInvoker' so the
productName 'Hermes Setup' doesn't trip Windows's installer-
detection heuristic and refuse to launch without elevation.
Also declares PerMonitorV2 DPI + UTF-8 active code page + Common
Controls v6.
Limitations of this initial version:
* No code signing -- Windows SmartScreen will warn once on Hermes-Setup.exe
('More info -> Run anyway'). The downstream binaries it produces
(Hermes.exe in win-unpacked/, the hermes CLI) are locally-built and
therefore don't carry MOTW, so they launch without SmartScreen
intervention. Cert procurement tracked separately.
* macOS and Linux build paths defined but untested -- Windows-only V1.
78 lines
2.4 KiB
TypeScript
78 lines
2.4 KiB
TypeScript
import { type CSSProperties } from 'react'
|
|
import { useStore } from '@nanostores/react'
|
|
import { Button } from '../components/button'
|
|
import {
|
|
$logPath,
|
|
openLogDir,
|
|
startInstall,
|
|
type BootstrapStateModel
|
|
} from '../store'
|
|
import { RefreshCw, FileText } from 'lucide-react'
|
|
|
|
interface FailureProps {
|
|
bootstrap: BootstrapStateModel
|
|
}
|
|
|
|
/*
|
|
* Failure screen. Same hero treatment as Welcome/Success — the wordmark
|
|
* carries the brand, so we keep it across every terminal state.
|
|
*
|
|
* The actual error message lives below in muted text. Two clear
|
|
* affordances: Retry (primary) and Open log folder (secondary).
|
|
*/
|
|
export default function Failure({ bootstrap }: FailureProps) {
|
|
const logPath = useStore($logPath)
|
|
|
|
return (
|
|
<div className="hermes-fade-in flex h-full flex-col items-center justify-center gap-6 px-12 py-10">
|
|
<div className="w-full max-w-2xl min-w-0 text-center">
|
|
<p
|
|
className="fit-text mx-auto mb-4 w-full font-['Collapse'] font-bold uppercase leading-[0.9] tracking-[0.08em] text-destructive mix-blend-plus-lighter dark:text-destructive/90"
|
|
style={
|
|
{
|
|
'--fit-text-line-height': '0.9',
|
|
'--fit-text-max': '5rem',
|
|
'--fit-text-min': '2.25rem'
|
|
} as CSSProperties
|
|
}
|
|
>
|
|
<span>
|
|
<span>Install didn’t finish</span>
|
|
</span>
|
|
<span aria-hidden="true">Install didn’t finish</span>
|
|
</p>
|
|
|
|
<p className="m-0 mx-auto max-w-xl text-center text-sm leading-normal tracking-tight text-muted-foreground">
|
|
{bootstrap.error ?? 'Something went wrong during installation.'}
|
|
</p>
|
|
</div>
|
|
|
|
<div className="flex items-center gap-3">
|
|
<Button
|
|
onClick={() => void startInstall()}
|
|
size="lg"
|
|
className="inline-flex items-center gap-2 px-6"
|
|
>
|
|
<RefreshCw size={16} />
|
|
Retry install
|
|
</Button>
|
|
<Button
|
|
variant="outline"
|
|
size="lg"
|
|
onClick={() => void openLogDir()}
|
|
className="inline-flex items-center gap-2"
|
|
>
|
|
<FileText size={16} />
|
|
Open log folder
|
|
</Button>
|
|
</div>
|
|
|
|
{logPath && (
|
|
<p className="max-w-lg text-center text-xs text-muted-foreground/70">
|
|
Log: <code className="font-mono">{logPath}</code>
|
|
</p>
|
|
)}
|
|
</div>
|
|
)
|
|
}
|