From 7dde6153a1c82c82e9f44ec70238d6f05c2c0ffd Mon Sep 17 00:00:00 2001
From: swwind <i@sww.moe>
Date: Sun, 23 Aug 2026 16:33:02 +0800
Subject: [PATCH 1/2] feat: detect Fresh

---
 icons/fresh.png               | Bin 0 -> 3834 bytes
 icons/src/fresh.svg           |   1 +
 src/signatures/meta.js        |  45 ++++++++++++++++++++++++++++++++++
 test/fixtures/fresh/page.json |   7 ++++++
 test/run.mjs                  |  20 +++++++++++++++
 5 files changed, 73 insertions(+)
 create mode 100644 icons/fresh.png
 create mode 100644 icons/src/fresh.svg
 create mode 100644 test/fixtures/fresh/page.json

diff --git a/icons/fresh.png b/icons/fresh.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6fc8e891d8c803f7833cdb2bf96a2ef0d62afe0
GIT binary patch
literal 3834
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

literal 0
HcmV?d00001

diff --git a/icons/src/fresh.svg b/icons/src/fresh.svg
new file mode 100644
index 0000000..a3ed230
--- /dev/null
+++ b/icons/src/fresh.svg
@@ -0,0 +1 @@
+<svg width="40" height="40" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M34.092 8.845C38.929 20.652 34.092 27 30 30.5c1 3.5-2.986 4.222-4.5 2.5-4.457 1.537-13.512 1.487-20-5C2 24.5 4.73 16.714 14 11.5c8-4.5 16-7 20.092-2.655Z" fill="#FFDB1E"/><path d="M14 11.5c6.848-4.497 15.025-6.38 18.368-3.47C37.5 12.5 21.5 22.612 15.5 25c-6.5 2.587-3 8.5-6.5 8.5-3 0-2.5-4-5.183-7.75C2.232 23.535 6.16 16.648 14 11.5Z" fill="#fff" stroke="#FFDB1E"/><path d="M28.535 8.772c4.645 1.25-.365 5.695-4.303 8.536-3.732 2.692-6.606 4.21-7.923 4.83-.366.173-1.617-2.252-1.617-1 0 .417-.7 2.238-.934 2.326-1.365.512-4.223 1.29-5.835 1.29-3.491 0-1.923-4.754 3.014-9.122.892-.789 1.478-.645 2.283-.645-.537-.773-.534-.917.403-1.546C17.79 10.64 23 8.77 25.212 8.42c.366.014.82.35.82.629.41-.14 2.095-.388 2.503-.278Z" fill="#FFE600"/><path d="M14.297 16.49c.985-.747 1.644-1.01 2.099-2.526.566.121.841-.08 1.29-.701.324.466 1.657.608 2.453.701-.715.451-1.057.852-1.452 2.106-1.464-.611-3.167-.302-4.39.42Z" fill="#fff"/></svg>
diff --git a/src/signatures/meta.js b/src/signatures/meta.js
index a705fde..b5c1444 100644
--- a/src/signatures/meta.js
+++ b/src/signatures/meta.js
@@ -17,6 +17,46 @@
   const relations = (root.StackRelations = root.StackRelations || []);
 
   list.push(
+    {
+      id: 'fresh',
+      name: 'Fresh',
+      category: 'meta-framework',
+      color: '#f7c948',
+      home: 'https://usefresh.dev',
+      rules: [
+        // Fresh 1 serves its client runtime and island chunks from this
+        // reserved directory. seen: Fresh 1 documentation and starter output
+        {
+          id: 'fresh1-asset-url',
+          where: ['url', 'html'],
+          re: /\/_frsh\/(?:js\/|refresh\.js)/,
+          weight: STRONG,
+          max: 1,
+          desc: '/_frsh/ Fresh 1 runtime asset directory',
+        },
+        // Fresh 1 serializes island props into this uniquely named script.
+        // seen: Fresh 1 counter starter output
+        {
+          id: 'fresh1-state',
+          where: ['dom', 'html'],
+          str: '__FRSH_STATE',
+          weight: STRONG,
+          max: 1,
+          desc: '__FRSH_STATE island hydration payload (Fresh 1)',
+        },
+        // Fresh 2's built-in partial navigation is expressed directly in
+        // markup, including on the framework's own site. seen: usefresh.dev
+        {
+          id: 'fresh2-navigation-attrs',
+          where: ['dom', 'html'],
+          re: /\bf-(?:client-nav|partial|partial-mode|partial-target)\b/,
+          weight: STRONG,
+          min: 2,
+          desc: 'f-client-nav / f-partial Fresh 2 navigation attribute',
+        },
+      ],
+    },
+
     {
       id: 'next',
       name: 'Next.js',
@@ -498,6 +538,11 @@
    * finding and stays its own card.
    */
   relations.push(
+    {
+      id: 'fresh',
+      builtOn: ['preact'],
+      note: 'Fresh is built on Preact, so Preact runtime markers are attributed to Fresh.',
+    },
     {
       id: 'next',
       builtOn: ['react', 'turbopack', 'webpack'],
diff --git a/test/fixtures/fresh/page.json b/test/fixtures/fresh/page.json
new file mode 100644
index 0000000..7dace38
--- /dev/null
+++ b/test/fixtures/fresh/page.json
@@ -0,0 +1,7 @@
+{
+  "markup": "<!doctype html><html><head><link rel=\"modulepreload\" href=\"/_frsh/js/8da4be105acc5e866d96dbd1367699fea082142b/main.js\"></head><body><!--frsh-counter:0--><div><button>+1</button></div><!--/frsh-counter:0--><script id=\"__FRSH_STATE\" type=\"application/json\">{\"v\":[]}</script></body></html>",
+  "dom": "script#__FRSH_STATE\nlink[href=\"/_frsh/js/8da4be105acc5e866d96dbd1367699fea082142b/main.js\"]",
+  "props": [],
+  "urls": ["https://example.test/_frsh/js/8da4be105acc5e866d96dbd1367699fea082142b/main.js"],
+  "globals": []
+}
diff --git a/test/run.mjs b/test/run.mjs
index ba33f42..705a55a 100644
--- a/test/run.mjs
+++ b/test/run.mjs
@@ -90,6 +90,9 @@ const CASES = [
   { dir: 'knockout', primary: 'knockout', version: '3.5.3', also: ['jquery'], only: true },
   { dir: 'ember', primary: 'ember', version: null, also: ['webpack'], only: true },
   { dir: 'stimulus', primary: 'stimulus', version: null, only: true },
+  // Fresh 1's island state and runtime asset path are server-rendered page
+  // markers; Preact, when present, is intrinsic and gets folded in.
+  { dir: 'fresh', primary: 'fresh', version: '≤ 1', only: true },
 
   // ---- meta-frameworks ------------------------------------------------
   // The UI framework and the bundler are intrinsic to each of these, so they
@@ -250,6 +253,23 @@ describe('signature engine', () => {
     assert.deepStrictEqual(detections.map((d) => d.id), []);
   });
 
+  it('unrelated f-prefixed attributes are not Fresh', () => {
+    const { detections } = analyze({
+      sources: [{ kind: 'dom', label: 'page DOM', text: '<form f-action="save" f-state="dirty">' }],
+      globals: [],
+    });
+    assert.deepStrictEqual(detections.map((d) => d.id), []);
+  });
+
+  it('Fresh 2 navigation attributes', () => {
+    const { detections } = analyze({
+      sources: [{ kind: 'dom', label: 'page DOM', text: '<main f-client-nav><button f-partial="/recipes/lemonade">' }],
+      globals: [],
+    });
+    assert.deepStrictEqual(detections.map((d) => d.id), ['fresh']);
+    assert.strictEqual(detections[0].version.text, '≥ 2');
+  });
+
   // window globals alone should be enough, with no script bodies at all.
   it('globals-only', () => {
     const { detections } = analyze({ sources: [], globals: ['webpackChunkmyapp'] });

From 721c799e50e2f8cdcb5826da80938279b9e95968 Mon Sep 17 00:00:00 2001
From: swwind <i@sww.moe>
Date: Sun, 23 Aug 2026 16:35:32 +0800
Subject: [PATCH 2/2] docs: document Fresh detection

---
 README.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index d6880f6..1e582fa 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,7 @@ about a page than the **UI library** underneath it, which says more than the
 | | Recognised by | Version |
 | --- | --- | --- |
 | **Next.js** | `window.next`, `__NEXT_DATA__`, `self.__next_f`, `/_next/static/`, the `webpackChunk_N_E` registry | **exact**, off `window.next.version` |
+| **Fresh** | Fresh 1's `/_frsh/` runtime assets and `__FRSH_STATE`; Fresh 2's `f-client-nav` / `f-partial` attributes | `≤ 1` or `≥ 2`, from the runtime marker |
 | **Nuxt** | `useNuxtApp`, `__NUXT__`, `__buildAssetsURL`, `/_nuxt/` | none |
 | **SvelteKit** | `__sveltekit_…`, `/_app/immutable/`, `data-sveltekit-preload-data` | none |
 | **Astro** | `<astro-island>` and its runtime, `astro:page-load`, `/_astro/`, `data-astro-cid-…` | **exact** from the generator meta tag |
@@ -187,10 +188,10 @@ property called `version`, being reported as a release.
 
 ### Absorbed evidence
 
-Next.js *is* React and ships webpack or Turbopack. Reporting all three as
-separate findings would be technically true and useless, so a meta-framework
-absorbs what is intrinsic to it and the popup shows those traces as chips under
-the card, evidence and all.
+Next.js *is* React and ships webpack or Turbopack; Fresh is built on Preact.
+Reporting those implementation details as separate findings would be technically
+true and useless, so a meta-framework absorbs what is intrinsic to it and the
+popup shows those traces as chips under the card, evidence and all.
 
 Only intrinsic relationships are folded in. React on webpack is a *choice*, not
 a fact about React, so those stay two findings — and Astro keeps its islands
@@ -332,6 +333,7 @@ Every icon is the project's own artwork.
 | rspack | the site favicon, `https://assets.rspack.rs/rspack/favicon-128x128.png` |
 | turbopack | the Turbo mark from the [vercel/turborepo](https://github.com/vercel/turborepo) README |
 | astro | the mark from `https://astro.build/favicon.svg` |
+| fresh | the [official Fresh SVG](https://github.com/freshframework/fresh/blob/main/www/static/logo.svg) |
 | knockout | the [Knockout organisation](https://github.com/knockout) avatar on GitHub — the same script K as their favicon, at 460 px instead of 16 |
 | sveltekit | the Svelte mark, which is SvelteKit's own branding too — the toolbar cannot tell the two apart, the popup can |