From d8919b99d01f4f94163bf432305f1064e3cd6658 Mon Sep 17 00:00:00 2001 From: Ian Clarke Date: Fri, 27 Mar 2026 16:57:49 -0500 Subject: [PATCH 1/4] docs: update Windows quickstart to use setup wizard Replace the old `cargo install freenet` instructions with a direct download link. Running freenet.exe now shows a setup wizard that handles installation automatically (added in freenet-core#3680). Closes #19 Co-Authored-By: Claude Opus 4.6 (1M context) --- hugo-site/content/quickstart/_index.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/hugo-site/content/quickstart/_index.md b/hugo-site/content/quickstart/_index.md index cab982bf..9d8c52e6 100644 --- a/hugo-site/content/quickstart/_index.md +++ b/hugo-site/content/quickstart/_index.md @@ -28,13 +28,9 @@ This downloads and installs Freenet, then starts it as a background service. ### Windows -Install from source with [Cargo](https://rustup.rs/): - -```bash -cargo install freenet -``` - -Then start Freenet with `freenet network`. +[Download Freenet](https://github.com/freenet/freenet-core/releases/latest/download/freenet-x86_64-pc-windows-msvc.zip), +extract the zip, and run `freenet.exe`. The setup wizard will guide you through installation, then start +Freenet as a background service with a system tray icon. ## Step 2: Join Freenet Official From c35f122f3a1c4b8c8370278a168e9da75417d9e1 Mon Sep 17 00:00:00 2001 From: Ian Clarke Date: Fri, 27 Mar 2026 17:10:56 -0500 Subject: [PATCH 2/4] docs: link directly to freenet.exe instead of zip Co-Authored-By: Claude Opus 4.6 (1M context) --- hugo-site/content/quickstart/_index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/hugo-site/content/quickstart/_index.md b/hugo-site/content/quickstart/_index.md index 9d8c52e6..a0d38ccf 100644 --- a/hugo-site/content/quickstart/_index.md +++ b/hugo-site/content/quickstart/_index.md @@ -28,9 +28,9 @@ This downloads and installs Freenet, then starts it as a background service. ### Windows -[Download Freenet](https://github.com/freenet/freenet-core/releases/latest/download/freenet-x86_64-pc-windows-msvc.zip), -extract the zip, and run `freenet.exe`. The setup wizard will guide you through installation, then start -Freenet as a background service with a system tray icon. +[Download freenet.exe](https://github.com/freenet/freenet-core/releases/latest/download/freenet.exe) +and run it. The setup wizard will guide you through installation, then start Freenet as a background service +with a system tray icon. ## Step 2: Join Freenet Official From c9eadeb110b2189645db0d44ece9155638f5c755 Mon Sep 17 00:00:00 2001 From: Ian Clarke Date: Fri, 27 Mar 2026 17:24:36 -0500 Subject: [PATCH 3/4] feat: auto-detect OS on quickstart page with tabbed install instructions Adds an os-install shortcode that detects the visitor's OS via navigator.platform and shows the matching install tab by default. All three options (Windows, macOS, Linux) remain accessible as tabs. Co-Authored-By: Claude Opus 4.6 (1M context) --- hugo-site/content/quickstart/_index.md | 16 +-- hugo-site/layouts/shortcodes/os-install.html | 144 +++++++++++++++++++ 2 files changed, 145 insertions(+), 15 deletions(-) create mode 100644 hugo-site/layouts/shortcodes/os-install.html diff --git a/hugo-site/content/quickstart/_index.md b/hugo-site/content/quickstart/_index.md index a0d38ccf..3247ace7 100644 --- a/hugo-site/content/quickstart/_index.md +++ b/hugo-site/content/quickstart/_index.md @@ -16,21 +16,7 @@ Get started with Freenet in minutes. Install the software and join River—the w ## Step 1: Install Freenet -### Linux & macOS - -Run this command in your terminal: - -```bash -curl -fsSL https://freenet.org/install.sh | sh -``` - -This downloads and installs Freenet, then starts it as a background service. - -### Windows - -[Download freenet.exe](https://github.com/freenet/freenet-core/releases/latest/download/freenet.exe) -and run it. The setup wizard will guide you through installation, then start Freenet as a background service -with a system tray icon. +{{< os-install >}} ## Step 2: Join Freenet Official diff --git a/hugo-site/layouts/shortcodes/os-install.html b/hugo-site/layouts/shortcodes/os-install.html new file mode 100644 index 00000000..3a0f1290 --- /dev/null +++ b/hugo-site/layouts/shortcodes/os-install.html @@ -0,0 +1,144 @@ + + +
+
+ + + +
+ +
+

Download freenet.exe + and run it. The setup wizard will guide you through installation, then start Freenet as a background + service with a system tray icon.

+
+ +
+

Run this command in your terminal:

+ 
curl -fsSL https://freenet.org/install.sh | sh
+

This downloads and installs Freenet, then starts it as a background service.

+
+ +
+

Run this command in your terminal:

+ 
curl -fsSL https://freenet.org/install.sh | sh
+

This downloads and installs Freenet, then starts it as a background service.

+
+
+ + From 3e2815f52fd3c2a93f16418b1676d6c4bcaa1875 Mon Sep 17 00:00:00 2001 From: Ian Clarke Date: Sun, 29 Mar 2026 14:53:54 -0500 Subject: [PATCH 4/4] fix: add accessibility, JS fallback, and modern OS detection - Add ARIA roles/attributes for screen reader support (tablist, tab, tabpanel) - Default Linux tab active in HTML so content is visible without JS - Use navigator.userAgentData with navigator.platform fallback - Add aria-hidden to decorative SVG icons Co-Authored-By: Claude Opus 4.6 (1M context) --- hugo-site/layouts/shortcodes/os-install.html | 32 +++++++++++++------- 1 file changed, 21 insertions(+), 11 deletions(-) diff --git a/hugo-site/layouts/shortcodes/os-install.html b/hugo-site/layouts/shortcodes/os-install.html index 3a0f1290..a9d24f55 100644 --- a/hugo-site/layouts/shortcodes/os-install.html +++ b/hugo-site/layouts/shortcodes/os-install.html @@ -78,34 +78,34 @@
-
- - -
-
+

Download freenet.exe and run it. The setup wizard will guide you through installation, then start Freenet as a background service with a system tray icon.

-
+

Run this command in your terminal:

curl -fsSL https://freenet.org/install.sh | sh

This downloads and installs Freenet, then starts it as a background service.

-
+

Run this command in your terminal:

curl -fsSL https://freenet.org/install.sh | sh

This downloads and installs Freenet, then starts it as a background service.

@@ -115,6 +115,14 @@