From 36f62a3285c3f10e91d129246034c6f5a3c765b2 Mon Sep 17 00:00:00 2001
From: Prospector <6166773+Prospector@users.noreply.github.com>
Date: Thu, 26 Mar 2026 14:10:01 -0700
Subject: [PATCH] refactor: move flags into settings, change icon (#5678)

* refactor: move flags into settings, change icon

* fix: use ButtonStyled for app
---
 .../components/ui/modal/AppSettingsModal.vue  | 10 +--
 .../ui/settings/FeatureFlagSettings.vue       | 23 +++--
 .../app-frontend/src/locales/en-US/index.json |  3 -
 apps/frontend/src/layouts/default.vue         | 17 ++--
 apps/frontend/src/locales/en-US/index.json    |  3 -
 .../src/middleware/flags-redirect.global.ts   |  6 ++
 apps/frontend/src/pages/flags.vue             | 78 -----------------
 apps/frontend/src/pages/settings.vue          |  9 ++
 apps/frontend/src/pages/settings/flags.vue    | 87 +++++++++++++++++++
 packages/ui/src/locales/en-US/index.json      |  3 +
 packages/ui/src/utils/common-messages.ts      |  4 +
 11 files changed, 137 insertions(+), 106 deletions(-)
 create mode 100644 apps/frontend/src/middleware/flags-redirect.global.ts
 delete mode 100644 apps/frontend/src/pages/flags.vue
 create mode 100644 apps/frontend/src/pages/settings/flags.vue

diff --git a/apps/app-frontend/src/components/ui/modal/AppSettingsModal.vue b/apps/app-frontend/src/components/ui/modal/AppSettingsModal.vue
index 1635b46a7..9419d6374 100644
--- a/apps/app-frontend/src/components/ui/modal/AppSettingsModal.vue
+++ b/apps/app-frontend/src/components/ui/modal/AppSettingsModal.vue
@@ -6,12 +6,13 @@ import {
 	LanguagesIcon,
 	ModrinthIcon,
 	PaintbrushIcon,
-	ReportIcon,
 	SettingsIcon,
 	ShieldIcon,
+	ToggleRightIcon,
 } from '@modrinth/assets'
 import {
 	commonMessages,
+	commonSettingsMessages,
 	defineMessage,
 	defineMessages,
 	ProgressBar,
@@ -95,11 +96,8 @@ const tabs = [
 		content: ResourceManagementSettings,
 	},
 	{
-		name: defineMessage({
-			id: 'app.settings.tabs.feature-flags',
-			defaultMessage: 'Feature flags',
-		}),
-		icon: ReportIcon,
+		name: commonSettingsMessages.featureFlags,
+		icon: ToggleRightIcon,
 		content: FeatureFlagSettings,
 		developerOnly: true,
 	},
diff --git a/apps/app-frontend/src/components/ui/settings/FeatureFlagSettings.vue b/apps/app-frontend/src/components/ui/settings/FeatureFlagSettings.vue
index 679dfc48e..dadcab73b 100644
--- a/apps/app-frontend/src/components/ui/settings/FeatureFlagSettings.vue
+++ b/apps/app-frontend/src/components/ui/settings/FeatureFlagSettings.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { Toggle } from '@modrinth/ui'
+import { ButtonStyled, Toggle } from '@modrinth/ui'
 import { ref, watch } from 'vue'
 
 import { get as getSettings, set as setSettings } from '@/helpers/settings.ts'
@@ -31,11 +31,20 @@ watch(
 				{{ option.replaceAll('_', ' ') }}
 			</h2>
 		</div>
-
-		<Toggle
-			id="advanced-rendering"
-			:model-value="themeStore.getFeatureFlag(option)"
-			@update:model-value="() => setFeatureFlag(option, !themeStore.getFeatureFlag(option))"
-		/>
+		<div class="flex items-center gap-2">
+			<ButtonStyled type="transparent">
+				<button
+					:disabled="themeStore.getFeatureFlag(option) === DEFAULT_FEATURE_FLAGS[option]"
+					@click="setFeatureFlag(option, DEFAULT_FEATURE_FLAGS[option])"
+				>
+					Reset to default
+				</button>
+			</ButtonStyled>
+			<Toggle
+				id="advanced-rendering"
+				:model-value="themeStore.getFeatureFlag(option)"
+				@update:model-value="() => setFeatureFlag(option, !themeStore.getFeatureFlag(option))"
+			/>
+		</div>
 	</div>
 </template>
diff --git a/apps/app-frontend/src/locales/en-US/index.json b/apps/app-frontend/src/locales/en-US/index.json
index d33b0b5bd..f7f558ae6 100644
--- a/apps/app-frontend/src/locales/en-US/index.json
+++ b/apps/app-frontend/src/locales/en-US/index.json
@@ -197,9 +197,6 @@
   "app.settings.tabs.default-instance-options": {
     "message": "Default instance options"
   },
-  "app.settings.tabs.feature-flags": {
-    "message": "Feature flags"
-  },
   "app.settings.tabs.java-installations": {
     "message": "Java installations"
   },
diff --git a/apps/frontend/src/layouts/default.vue b/apps/frontend/src/layouts/default.vue
index 6a109b8df..6ef59f08c 100644
--- a/apps/frontend/src/layouts/default.vue
+++ b/apps/frontend/src/layouts/default.vue
@@ -473,7 +473,8 @@
 						<SettingsIcon aria-hidden="true" /> {{ formatMessage(commonMessages.settingsLabel) }}
 					</template>
 					<template #flags>
-						<ReportIcon aria-hidden="true" /> {{ formatMessage(messages.featureFlags) }}
+						<ToggleRightIcon aria-hidden="true" />
+						{{ formatMessage(commonSettingsMessages.featureFlags) }}
 					</template>
 					<template #projects>
 						<BoxIcon aria-hidden="true" /> {{ formatMessage(messages.projects) }}
@@ -585,9 +586,9 @@
 							<ScaleIcon aria-hidden="true" />
 							{{ formatMessage(commonMessages.moderationLabel) }}
 						</NuxtLink>
-						<NuxtLink v-if="flags.developerMode" class="iconified-button" to="/flags">
-							<ReportIcon aria-hidden="true" />
-							{{ formatMessage(messages.featureFlags) }}
+						<NuxtLink v-if="flags.developerMode" class="iconified-button" to="/settings/flags">
+							<ToggleRightIcon aria-hidden="true" />
+							{{ formatMessage(commonSettingsMessages.featureFlags) }}
 						</NuxtLink>
 					</template>
 					<NuxtLink class="iconified-button" to="/settings">
@@ -724,6 +725,7 @@ import {
 	SettingsIcon,
 	ShieldAlertIcon,
 	SunIcon,
+	ToggleRightIcon,
 	TransferIcon,
 	UserIcon,
 	UserSearchIcon,
@@ -734,6 +736,7 @@ import {
 	ButtonStyled,
 	commonMessages,
 	commonProjectTypeCategoryMessages,
+	commonSettingsMessages,
 	defineMessages,
 	injectModrinthClient,
 	OverflowMenu,
@@ -918,10 +921,6 @@ const messages = defineMessages({
 		id: 'layout.nav.upgrade-to-modrinth-plus',
 		defaultMessage: 'Upgrade to Modrinth+',
 	},
-	featureFlags: {
-		id: 'layout.nav.feature-flags',
-		defaultMessage: 'Feature flags',
-	},
 	projects: {
 		id: 'layout.nav.projects',
 		defaultMessage: 'Projects',
@@ -1045,7 +1044,7 @@ const userMenuOptions = computed(() => {
 		},
 		{
 			id: 'flags',
-			link: '/flags',
+			link: '/settings/flags',
 			shown: flags.value.developerMode,
 		},
 		{
diff --git a/apps/frontend/src/locales/en-US/index.json b/apps/frontend/src/locales/en-US/index.json
index b35a8fe25..f91c60de9 100644
--- a/apps/frontend/src/locales/en-US/index.json
+++ b/apps/frontend/src/locales/en-US/index.json
@@ -1709,9 +1709,6 @@
   "layout.nav.discover-content": {
     "message": "Discover content"
   },
-  "layout.nav.feature-flags": {
-    "message": "Feature flags"
-  },
   "layout.nav.get-modrinth-app": {
     "message": "Get Modrinth App"
   },
diff --git a/apps/frontend/src/middleware/flags-redirect.global.ts b/apps/frontend/src/middleware/flags-redirect.global.ts
new file mode 100644
index 000000000..40c7ff017
--- /dev/null
+++ b/apps/frontend/src/middleware/flags-redirect.global.ts
@@ -0,0 +1,6 @@
+export default defineNuxtRouteMiddleware((to) => {
+	if (to.path.startsWith('/flags')) {
+		const target = to.fullPath.replace('/flags', '/settings/flags')
+		return navigateTo(target, { redirectCode: 301 })
+	}
+})
diff --git a/apps/frontend/src/pages/flags.vue b/apps/frontend/src/pages/flags.vue
deleted file mode 100644
index 41462d3da..000000000
--- a/apps/frontend/src/pages/flags.vue
+++ /dev/null
@@ -1,78 +0,0 @@
-<script setup lang="ts">
-import { SearchIcon } from '@modrinth/assets'
-import { StyledInput, Toggle } from '@modrinth/ui'
-import Fuse from 'fuse.js'
-import { computed, ref, shallowReactive } from 'vue'
-
-import {
-	DEFAULT_FEATURE_FLAGS,
-	type FeatureFlag,
-	saveFeatureFlags,
-	useFeatureFlags,
-} from '~/composables/featureFlags.ts'
-
-const flags = shallowReactive(useFeatureFlags().value)
-const searchQuery = ref('')
-
-const allFlags = computed(() => Object.keys(flags) as FeatureFlag[])
-
-const fuse = computed(
-	() =>
-		new Fuse(allFlags.value, {
-			threshold: 0.4,
-		}),
-)
-
-const filteredFlags = computed(() => {
-	if (!searchQuery.value.trim()) {
-		return allFlags.value
-	}
-	return fuse.value.search(searchQuery.value).map((result) => result.item)
-})
-
-useSeoMeta({
-	robots: 'noindex',
-})
-</script>
-
-<template>
-	<div class="mx-auto my-4 box-border w-[calc(100%-2rem)] max-w-[800px]">
-		<h1 class="mb-4 text-2xl font-bold text-contrast">Feature flags</h1>
-		<div class="mb-2">
-			<StyledInput
-				v-model="searchQuery"
-				type="search"
-				:icon="SearchIcon"
-				placeholder="Search flags..."
-				wrapper-class="w-full rounded-xl bg-bg-raised"
-			/>
-		</div>
-		<div class="flex flex-col gap-2">
-			<div
-				v-for="flag in filteredFlags"
-				:key="`flag-${flag}`"
-				class="flex flex-row flex-wrap items-center gap-2 rounded-2xl bg-bg-raised p-4"
-			>
-				<label :for="`toggle-${flag}`" class="flex-1">
-					<span class="block font-semibold capitalize">
-						{{ flag.replaceAll('_', ' ') }}
-					</span>
-					<p class="m-0 text-secondary">
-						Default:
-						<span :class="DEFAULT_FEATURE_FLAGS[flag] === false ? 'text-red' : 'text-green'">
-							{{ DEFAULT_FEATURE_FLAGS[flag] }}
-						</span>
-					</p>
-				</label>
-				<Toggle
-					:id="`toggle-${flag}`"
-					v-model="flags[flag]"
-					@update:model-value="() => saveFeatureFlags()"
-				/>
-			</div>
-			<p v-if="filteredFlags.length === 0" class="text-center text-secondary">
-				No flags found matching "{{ searchQuery }}"
-			</p>
-		</div>
-	</div>
-</template>
diff --git a/apps/frontend/src/pages/settings.vue b/apps/frontend/src/pages/settings.vue
index e698c8e2e..3c9690faa 100644
--- a/apps/frontend/src/pages/settings.vue
+++ b/apps/frontend/src/pages/settings.vue
@@ -20,6 +20,13 @@
 								icon: LanguagesIcon,
 								badge: `${formatMessage(commonMessages.beta)}`,
 							},
+							flags.developerMode
+								? {
+										link: '/settings/flags',
+										label: formatMessage(commonSettingsMessages.featureFlags),
+										icon: ToggleRightIcon,
+									}
+								: null,
 							auth.user ? { type: 'heading', label: formatMessage(messages.account) } : null,
 							auth.user
 								? {
@@ -91,6 +98,7 @@ import {
 	PaintbrushIcon,
 	ServerIcon,
 	ShieldIcon,
+	ToggleRightIcon,
 	UserIcon,
 } from '@modrinth/assets'
 import { commonMessages, commonSettingsMessages, defineMessages, useVIntl } from '@modrinth/ui'
@@ -116,6 +124,7 @@ const messages = defineMessages({
 
 const route = useNativeRoute()
 const auth = await useAuth()
+const flags = useFeatureFlags()
 
 useSeoMeta({
 	robots: 'noindex',
diff --git a/apps/frontend/src/pages/settings/flags.vue b/apps/frontend/src/pages/settings/flags.vue
new file mode 100644
index 000000000..d175e0f47
--- /dev/null
+++ b/apps/frontend/src/pages/settings/flags.vue
@@ -0,0 +1,87 @@
+<script setup lang="ts">
+import { SearchIcon } from '@modrinth/assets'
+import { ButtonStyled, StyledInput, Toggle } from '@modrinth/ui'
+import Fuse from 'fuse.js'
+import { computed, ref, shallowReactive } from 'vue'
+
+import {
+	DEFAULT_FEATURE_FLAGS,
+	type FeatureFlag,
+	saveFeatureFlags,
+	useFeatureFlags,
+} from '~/composables/featureFlags.ts'
+
+const flags = shallowReactive(useFeatureFlags().value)
+const searchQuery = ref('')
+
+const allFlags = computed(() => Object.keys(flags) as FeatureFlag[])
+
+function resetFlag(flag: FeatureFlag) {
+	flags[flag] = DEFAULT_FEATURE_FLAGS[flag]
+	saveFeatureFlags()
+}
+
+const fuse = computed(
+	() =>
+		new Fuse(allFlags.value, {
+			threshold: 0.4,
+		}),
+)
+
+const filteredFlags = computed(() => {
+	if (!searchQuery.value.trim()) {
+		return allFlags.value
+	}
+	return fuse.value.search(searchQuery.value).map((result) => result.item)
+})
+
+useSeoMeta({
+	robots: 'noindex',
+})
+</script>
+
+<template>
+	<div class="mb-2">
+		<StyledInput
+			v-model="searchQuery"
+			type="search"
+			:icon="SearchIcon"
+			placeholder="Search flags..."
+			wrapper-class="w-full rounded-xl bg-bg-raised"
+		/>
+	</div>
+	<div class="flex flex-col gap-2">
+		<div
+			v-for="flag in filteredFlags"
+			:key="`flag-${flag}`"
+			class="flex flex-row flex-wrap items-center gap-2 rounded-2xl bg-bg-raised p-4"
+		>
+			<label :for="`toggle-${flag}`" class="flex-1">
+				<span class="block font-semibold capitalize">
+					{{ flag.replaceAll('_', ' ') }}
+				</span>
+				<p class="m-0 text-secondary">
+					Default:
+					<span :class="DEFAULT_FEATURE_FLAGS[flag] === false ? 'text-red' : 'text-green'">
+						{{ DEFAULT_FEATURE_FLAGS[flag] }}
+					</span>
+				</p>
+			</label>
+			<div class="flex items-center gap-2">
+				<ButtonStyled type="transparent">
+					<button :disabled="flags[flag] === DEFAULT_FEATURE_FLAGS[flag]" @click="resetFlag(flag)">
+						Reset to default
+					</button>
+				</ButtonStyled>
+				<Toggle
+					:id="`toggle-${flag}`"
+					v-model="flags[flag]"
+					@update:model-value="() => saveFeatureFlags()"
+				/>
+			</div>
+		</div>
+		<p v-if="filteredFlags.length === 0" class="text-center text-secondary">
+			No flags found matching "{{ searchQuery }}"
+		</p>
+	</div>
+</template>
diff --git a/packages/ui/src/locales/en-US/index.json b/packages/ui/src/locales/en-US/index.json
index 5bb2fc169..60c441561 100644
--- a/packages/ui/src/locales/en-US/index.json
+++ b/packages/ui/src/locales/en-US/index.json
@@ -2714,6 +2714,9 @@
   "settings.display.theme.title": {
     "defaultMessage": "Color theme"
   },
+  "settings.feature-flags.title": {
+    "defaultMessage": "Feature flags"
+  },
   "settings.language.categories.default": {
     "defaultMessage": "Standard languages"
   },
diff --git a/packages/ui/src/utils/common-messages.ts b/packages/ui/src/utils/common-messages.ts
index 5e6a5764c..42237784f 100644
--- a/packages/ui/src/utils/common-messages.ts
+++ b/packages/ui/src/utils/common-messages.ts
@@ -856,6 +856,10 @@ export const commonSettingsMessages = defineMessages({
 		id: 'settings.billing.title',
 		defaultMessage: 'Billing and subscriptions',
 	},
+	featureFlags: {
+		id: 'settings.feature-flags.title',
+		defaultMessage: 'Feature flags',
+	},
 	language: {
 		id: 'settings.language.title',
 		defaultMessage: 'Language',