From c75225542ed8ed73923648c102d8745cdf4a47fc Mon Sep 17 00:00:00 2001
From: ToBinio <tobias.frischmann@proton.me>
Date: Thu, 30 Apr 2026 10:13:01 +0200
Subject: [PATCH] imrpove seo text

---
 app/app.vue                        |   5 -
 app/composables/useExplanations.ts | 157 ++++++++++++++++++++++-------
 app/pages/charts.vue               |  30 +++---
 app/pages/index.vue                |   5 +
 4 files changed, 138 insertions(+), 59 deletions(-)

diff --git a/app/app.vue b/app/app.vue
index cb4faf4..903eeec 100644
--- a/app/app.vue
+++ b/app/app.vue
@@ -4,11 +4,6 @@
 			lang: "en",
 		},
 	});
-
-	useSeoMeta({
-		description: "The site for stats all about Modrinth.com",
-		ogDescription: "The site for stats all about Modrinth.com",
-	});
 </script>
 
 <template>
diff --git a/app/composables/useExplanations.ts b/app/composables/useExplanations.ts
index 6d09dcc..95bb869 100644
--- a/app/composables/useExplanations.ts
+++ b/app/composables/useExplanations.ts
@@ -6,16 +6,92 @@ export function useExplanations(projectType: Ref<string>, stat: Ref<string>) {
 	});
 
 	const title = computed(() => {
-		return `Modrinth Statistics - ${firstLetterUpperCase(projectType.value)} ${firstLetterUpperCase(stat.value)}`;
+		return getTitle(projectType.value, stat.value);
 	});
 
 	const description = computed(() => {
-		return `See all Statistics about Modrinth - ${firstLetterUpperCase(projectType.value)} ${firstLetterUpperCase(stat.value)}`;
+		return getDescription(projectType.value, stat.value);
 	});
 
 	return { explanation, title, description };
 }
 
+function getTitle(type: string, stat: string): string | undefined {
+	function getDescriptionContext(s: string, t: string): string {
+		const statLower = s.toLowerCase();
+		const typeLower = t.toLowerCase();
+
+		switch (statLower) {
+			case "downloads":
+				return `Analyze ${typeLower} downloads overtime`;
+			case "versions":
+				return `Analyze number of ${typeLower} versions overtime`;
+			case "count":
+				return `Analyze number of ${typeLower} projects overtime`;
+			default:
+				return `${typeLower} ${statLower} analytics`;
+		}
+	}
+
+	switch (type.toLowerCase()) {
+		case "mod":
+		case "plugin":
+		case "datapack":
+		case "shader":
+		case "resourcepack":
+		case "modpack":
+			return `Modrinth ${firstLetterUpperCase(type)} ${firstLetterUpperCase(stat)} - ${getDescriptionContext(stat, type)}`;
+		case "projects":
+			return `Modrinth Projects Statistics - Platform Analytics`;
+		case "versions":
+			return `Modrinth Versions Statistics - Platform Analytics`;
+		case "authors":
+			return `Modrinth Authors Statistics - Platform Analytics`;
+		case "files":
+			return `Modrinth Files Statistics - Platform Analytics`;
+		case "revenue":
+			return `Modrinth Revenue Statistics - Platform Analytics`;
+	}
+}
+
+function getDescription(type: string, stat: string): string | undefined {
+	function getDescriptionContext(s: string, t: string): string {
+		const statLower = s.toLowerCase();
+		const typeLower = t.toLowerCase();
+
+		switch (statLower) {
+			case "downloads":
+				return `${typeLower} download trends and popularity across minecraft verions and modding loaders`;
+			case "versions":
+				return `${typeLower} versions uploaded to modrinth across minecraft verions and modding loaders`;
+			case "count":
+				return `the total number of unique ${typeLower} projects on all of modrinth across minecraft verions and modding loaders`;
+			default:
+				return `${typeLower} ${statLower} analytics`;
+		}
+	}
+
+	switch (type.toLowerCase()) {
+		case "mod":
+		case "plugin":
+		case "datapack":
+		case "shader":
+		case "resourcepack":
+		case "modpack":
+			return `Analyze ${getDescriptionContext(stat, type)}. Get deep insights into game version growth, loader distribution (Fabric/Forge/Quilt), and community adoption.`;
+		case "projects":
+			return `Analyze how the number of unique projects on Modrinth has changed over time.`;
+		case "versions":
+			return `Analyze how the number of versions uploaded to Modrinth has changed over time.`;
+		case "authors":
+			return `Analyze how the number of unique authors on Modrinth has changed over time.`;
+		case "files":
+			return `Analyze how the number of files uploaded to Modrinth has changed over time.`;
+		case "revenue":
+			return `Analyze how the revenue generated by Modrinth has changed over time. See how much money has generated and distributed to creators.`;
+	}
+}
+
 function getExplanations(type: string, stat: string): string | undefined {
 	switch (type.toLowerCase()) {
 		case "mod":
@@ -27,58 +103,61 @@ function getExplanations(type: string, stat: string): string | undefined {
 			return getProjectStatsExplanation(stat, type);
 		case "projects":
 			return `
- <h4>Number of Projects across all ProjectTypes</h4>
- <br/>
- This Count includes all projects types (mods, plugins, datapacks, shaders, resourcepacks, modpacks).
- `;
+                <h4>Number of Projects across all ProjectTypes</h4>
+                <p>This chart tracks the combined number of <strong>Mods, Plugins, Datapacks, Shaders, and Modpacks</strong>.
+                It represents the overall scale of Modrinth and the amount of different content available to players.</p>
+            `;
 		case "versions":
 			return `
- <h4>Number of Versions across all ProjectTypes</h4>
- <br/>
- This Count includes all projects types (mods, plugins, datapacks, shaders, resourcepacks, modpacks).
- `;
+			          <h4>Number of Versions across all ProjectTypes</h4>
+                <p>This chart tracks the combined number of versions across <strong>Mods, Plugins, Datapacks, Shaders, and Modpacks</strong>. This metric highlights how active
+                creators are in maintaining their content across all of Modrinth's supported project types.</p>
+            `;
 		case "authors":
 			return `
- <h4>Number of Authors on Modrinth</h4>
- `;
+			          <h4>Number of Authors on Modrinth</h4>
+                <p>This tracks the number of unique developers and artists contributing to the platform.
+                A growing author count indicates a healthy, expanding modding ecosystem.</p>
+            `;
 		case "files":
 			return `
- <h4>Number of Files hosted on Modrinth</h4>
- `;
+			          <h4>Number of Files hosted on Modrinth</h4>
+                <p>The total count of individual files hosted on Modrinth. This reflects the massive
+                amount of data managed by Modrinth.</p>
+            `;
 		case "revenue":
 			return `
- <h4>Revenue Generated by Modrinth in USD</h4>
- <br/>
- The revenue is Split between Modrinth and the Creators.
- `;
+			          <h4>Revenue Generated by Modrinth in USD</h4>
+                <p>Total revenue generated in USD. Modrinth operates on a <strong>creator-first model</strong>,
+                where funds are split between platform maintenance and direct payouts to the developers who make the community possible.</p>
+            `;
 	}
 }
 
 function getProjectStatsExplanation(stat: string, type: string) {
+	const typeUpper = firstLetterUpperCase(type);
+
 	switch (stat.toLowerCase()) {
-		case "versions": {
+		case "versions":
 			return `
- <h4>Number of Versions Supporting Each Loader/Game-Version</h4>
- <br/>
- Each version will be counted separately for every loader or game-version it supports. If a version supports multiple loaders or game-versions, it will be counted once for each supported loader/game-version.
- `;
-		}
-		case "count": {
+                <h4>${typeUpper} Versions Support by each Loader/Game-Version</h4>
+                <p>This tracks how many individual versions support specific loaders (like <strong>Fabric, Forge, or Quilt</strong>).
+                A single version supporting three loaders will count three times here to accurately reflect loader availability.
+                This can cause a bias though <strong>multi-loader</strong> projects, as they may increase popularity of niche loaders (such as Quilt) due to their cross-platform nature.</p>
+            `;
+		case "count":
 			return `
- <h4>Number of ${firstLetterUpperCase(type)}s Supporting Each Loader/Game-Version</h4>
- <br/>
- Each ${firstLetterUpperCase(type)} will only be counted once. This means if a ${firstLetterUpperCase(type)} has 10 versions supporting a single game-version in will still only be counted once.
- `;
-		}
-		case "downloads": {
+                <h4>Number of ${typeUpper}s Supporting Each Loader/Game-Version</h4>
+                <p>Unlike the versions metric, this tracks <strong>unique ${typeUpper}s</strong>. Even if a mod has 20 updates for
+                Minecraft 1.20.1 or multiple versions within a version group, it is only counted once here to show the actual variety of projects available.
+                A single mod supporting three loaders will count three times here to accurately reflect loader availability.
+                This can cause a bias though <strong>multi-loader</strong> projects, as they may increase popularity of niche loaders (such as Quilt) due to their cross-platform nature.</p>
+            `;
+		case "downloads":
 			return `
- <h4>Number of Downloads per Specific Loader/Game-Version</h4>
- <br/>
- If a version supports multiple loaders or game-versions, the downloads will be divided equally among each supported loader/game-version.
- <br/>
- <br/>
- This may exaggerate widely supported but less commonly used loaders or versions, such as Quilt.
- `;
-		}
+			          <h4>${typeUpper} Downloads per Loader/Game-Version</h4>
+                <p>Analysis of downloads across different game versions and loaders. When a file supports multiple versions or loaders,
+                downloads are split. This can cause a bias though <strong>multi-loader</strong> projects, as they may increase popularity of niche loaders (such as Quilt) due to their cross-platform nature.</p>
+            `;
 	}
 }
diff --git a/app/pages/charts.vue b/app/pages/charts.vue
index 0a8a8b2..cbf5edf 100644
--- a/app/pages/charts.vue
+++ b/app/pages/charts.vue
@@ -15,6 +15,20 @@
 	const projectType = useFilterItem("project_type", "mod");
 	const stat = useFilterItem("stat", "count");
 
+	const { explanation, title, description } = useExplanations(
+		projectType,
+		stat,
+	);
+
+	useHead({
+		title: title,
+	});
+
+	useSeoMeta({
+		description: description,
+		ogDescription: description,
+	});
+
 	const { isGlobalStats, isProjectStats, isRevenueStats } =
 		useTypeCategory(projectType);
 
@@ -97,20 +111,6 @@
 		if (!isFetching.value) lazyIsGroupData.value = isGroupData.value;
 	});
 
-	const { explanation, title, description } = useExplanations(
-		projectType,
-		stat,
-	);
-
-	useHead({
-		title: title,
-	});
-
-	useSeoMeta({
-		description: description,
-		ogDescription: description,
-	});
-
 	const sideBarOpen = ref(false);
 </script>
 
@@ -233,4 +233,4 @@
 		</div>
 	</div>
 </template>
-/>
+/> />
diff --git a/app/pages/index.vue b/app/pages/index.vue
index 1684923..4afbb37 100644
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -5,6 +5,11 @@
 		title: "Modrinth Statistics",
 	});
 
+	useSeoMeta({
+		description: "The site for stats all about Modrinth.com",
+		ogDescription: "The site for stats all about Modrinth.com",
+	});
+
 	useTracking();
 
 	const { data } = useFetch("/api/stats/global");
-- 
2.51.2