feat(settings): go to the settings route if the settings sub-route does not exist

Reviewed-on: #117
Reviewed-by: Jakob Gregory

package.json

@@ -17,6 +17,7 @@
     "vue-router": "^5.0.6"
   },
   "devDependencies": {
+    "@vue/test-utils": "^2.4.6",
     "@vitejs/plugin-vue": "^6.0.6",
     "jsdom": "^29.1.1",
     "vite": "^8.0.10",

src/features/footer/components/Footer.vue

@@ -35,7 +35,7 @@ const copyrightPeriod =
 <template>
     <footer class="global-footer">
         <div class="footer-segment">
-            <RouterLink to="settings" class="link">
+            <RouterLink to="/settings" class="link">
                 {{ t('preferences.settings') }}
             </RouterLink>
             <LanguageSwitchButton />

src/features/i18n/components/__tests__/LanguageSwitchButton.test.js

@@ -0,0 +1,114 @@
+/*
+Copyright 2026 Seekra
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { expect, test, describe, vi, beforeEach } from 'vitest';
+import { mount } from '@vue/test-utils';
+import LanguageSwitchButton from '../LanguageSwitchButton.vue';
+import { loadLanguage } from '@/i18n';
+
+vi.mock('@/i18n', () => ({
+    loadLanguage: vi.fn(() => Promise.resolve()),
+    LANGUAGES_RTL: ['ar', 'he'],
+    SUPPORTED_LANGUAGES: ['en', 'de', 'ar']
+}));
+
+vi.mock('vue-i18n', () => ({
+    useI18n: () => ({
+        t: (key) => key,
+        locale: { value: 'de' }
+    })
+}));
+
+vi.mock('@/features/icons/components/Icon.vue', () => ({
+    default: {
+        name: 'Icon',
+        template: '<span>Icon</span>'
+    }
+}));
+
+describe('LanguageSwitchButton.vue', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        localStorage.clear();
+        document.documentElement.lang = '';
+        document.documentElement.dir = '';
+    });
+
+    test('renders correctly with initial state closed', () => {
+        const wrapper = mount(LanguageSwitchButton);
+        
+        expect(wrapper.find('.language-button').exists()).toBe(true);
+        expect(wrapper.find('.language-dropdown').exists()).toBe(false);
+        expect(wrapper.find('.language-button').attributes('aria-expanded')).toBe('false');
+    });
+
+    test('opens the dropdown when language button is clicked', async () => {
+        const wrapper = mount(LanguageSwitchButton);
+        const button = wrapper.find('.language-button');
+        
+        await button.trigger('click');
+        
+        expect(wrapper.find('.language-dropdown').exists()).toBe(true);
+        expect(button.attributes('aria-expanded')).toBe('true');
+    });
+
+    const languageTestCases = [
+        { code: 'en', expectedDir: 'ltr' },
+        { code: 'de', expectedDir: 'ltr' },
+        { code: 'ar', expectedDir: 'rtl' }
+    ];
+
+    test.for(languageTestCases)('selectLanguage($code) sets localStorage, html attributes and changes layout direction to $expectedDir', async ({ code, expectedDir }) => {
+        const wrapper = mount(LanguageSwitchButton);
+        
+        await wrapper.find('.language-button').trigger('click');
+        
+        const options = wrapper.findAll('.language-dropdown li');
+        const optionToClick = options.find(opt => opt.text().includes(code));
+        
+        await optionToClick.trigger('click');
+
+        expect(loadLanguage).toHaveBeenCalledWith(code);
+        expect(localStorage.getItem('locale')).toBe(code);
+        expect(document.documentElement.lang).toBe(code);
+        expect(document.documentElement.dir).toBe(expectedDir);
+        expect(wrapper.find('.language-dropdown').exists()).toBe(false);
+    });
+
+    test('closes the dropdown when clicking outside the component', async () => {
+        const wrapper = mount(LanguageSwitchButton, {
+            attachTo: document.body
+        });
+
+        await wrapper.find('.language-button').trigger('click');
+        expect(wrapper.find('.language-dropdown').exists()).toBe(true);
+
+        await new Promise(resolve => setTimeout(resolve, 0));
+
+        const externalDiv = document.createElement('div');
+        document.body.appendChild(externalDiv);
+        
+        const clickEvent = new MouseEvent('click', { bubbles: true });
+        externalDiv.dispatchEvent(clickEvent);
+        
+        await wrapper.vm.$nextTick();
+
+        expect(wrapper.find('.language-dropdown').exists()).toBe(false);
+
+        wrapper.unmount();
+        externalDiv.remove();
+    });
+});

src/features/search/components/Searchbar.vue

@@ -73,7 +73,8 @@ const submitSearch = function () {
     border-radius: calc(var(--content-height) * 0.5 + var(--submit-button-padding-y) + var(--padding));
     padding: var(--padding);
     padding-left: var(--padding-left);
-    width: calc(100% - var(--padding-left));
+    width: 100%;
+    box-sizing: border-box;
 }
 
 .search-wrapper input {
@@ -83,6 +84,7 @@ const submitSearch = function () {
     font-size: 1rem;
     background: transparent;
     height: calc(var(--content-height) + 2 * var(--submit-button-padding-y));
+    padding-left: 12px;
 }
 
 .search-button {

src/features/settings/types/settingsConfig.js

@@ -53,10 +53,6 @@ limitations under the License.
  * @typedef {BoolSettingConfig | NumberSettingConfig | StringSettingConfig | SelectionSettingConfig | SectionSettingConfig} SettingConfigEntry
  */
 
-/**
- * @typedef {Object} SettingsConfig
- * @property {SettingConfigEntry[]} contents
- */
 /**
  * @typedef {{ type: 'bool', name: string, i18n: string, description?: string, default: boolean }} BoolSettingConfig
  * @typedef {{ type: 'number', name: string, i18n: string, description?: string, default: number }} NumberSettingConfig
@@ -64,5 +60,6 @@ limitations under the License.
  * @typedef {{ type: 'selection', name: string, i18n: string, description?: string, default: string | string[], allowMultiple?: boolean, options: SelectionOption[] }} SelectionSettingConfig
  * @typedef {{ type: 'section', name: string, i18n?: string, description?: string, content: SettingConfigEntry[] }} SectionSettingConfig
  * @typedef {BoolSettingConfig | NumberSettingConfig | StringSettingConfig | SelectionSettingConfig | SectionSettingConfig} SettingConfigEntry
- * @typedef {{ contents: SettingConfigEntry[] }} SettingsConfig
+ * @typedef {{ contents: SettingConfigEntry[] }} FirstLevelSettingConfigEntry
+ * @typedef {{ contents: FirstLevelSettingConfigEntry[] }} SettingsConfig
  */

src/features/settings/utils/__tests__/settingsValidator.test.js

@@ -0,0 +1,758 @@
+/*
+Copyright 2026 Seekra
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { describe, test, expect } from 'vitest';
+import { validateSettingsConfig, validateEntry, validateSelectionOptions, assertType, assertString } from '../settingsValidator';
+
+describe('validateSettingsConfig', () => {
+    test.for([
+        { raw: false, expected: false },
+        { raw: true, expected: false },
+        { raw: 0, expected: false },
+        { raw: 42, expected: false },
+        { raw: '', expected: false },
+        { raw: ' ', expected: false },
+        { raw: 'a', expected: false },
+        { raw: {}, expected: false },
+        { raw: {
+            contents: []
+        }, expected: true },
+        { raw: {
+            contents: [
+                {
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                }
+            ]
+        }, expected: true },
+        { raw: {
+            contents: [
+                {
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+            ]
+        }, expected: true },
+        { raw: {
+            contents: [
+                {
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: true },
+        { raw: {
+            contents: [
+                {
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            allowMultiple: false,
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: true },
+        { raw: {
+            contents: [
+                {
+                    type: 'bool',
+                    name: 'aStandaloneBooleanSetting',
+                    i18n: 'settings.settings.aStandaloneBooleanSetting',
+                    default: true
+                },
+                {
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            allowMultiple: false,
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: false },
+        { raw: {
+            contents: [
+                {
+                    type: 'section',
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43',
+                            default: 'true'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 42
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: false },
+        { raw: {
+            content: [
+                {
+                    type: 'section',
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: false },
+        { raw: {
+            content: [
+                {
+                    type: 'sectio',
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: false },
+        { raw: {
+            content: [
+                {
+                    type: 'sectio',
+                    name: 'general',
+                    i18n: 'settings.settings.general',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'copyOfGeneral',
+                    i18n: 'settings.settings.copyOfGeneral',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 42',
+                            default: false,
+                            i18n: 'settings.settings.general.enableFeature42'
+                        }
+                    ]
+                },
+                {
+                    type: 'section',
+                    name: 'aSection',
+                    i18n: 'settings.settings.aSection',
+                    content: [
+                        {
+                            type: 'bool',
+                            name: 'Enable feature 43',
+                            i18n: 'settings.settings.aSection.enableFeature43'
+                        },
+                        {
+                            type: 'selection',
+                            name: 'language',
+                            i18n: 'settings.settings.aSection.language.label',
+                            default: 'en',
+                            allowMultiple: 'false',
+                            options: [
+                                { name: 'en', i18n: 'settings.settings.aSection.language.options.en' },
+                                { name: 'de', i18n: 'settings.settings.aSection.language.options.de' },
+                            ]
+                        },
+                        {
+                            type: 'section',
+                            name: 'section2',
+                            i18n: 'settings.settings.aSection.section2.label',
+                            content: [
+                                {
+                                    type: 'string',
+                                    name: 'string',
+                                    i18n: 'settings.settings.aSection.sections.string',
+                                    default: 'str'
+                                }
+                            ]
+                        },
+                    ]
+                },
+            ]
+        }, expected: false }
+    ])('returns valid: $expected', ({ raw, expected }) => {
+        const result = validateSettingsConfig(raw);
+        if (!result.valid) {
+            console.error('Error message:', result.error);
+        };
+        expect(result.valid).toBe(expected);
+    });
+});
+
+describe('validateEntry', () => {
+    test.for([
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: false }],
+    
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: 42 }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: 0 }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: -42.7 }],
+    
+        [{ name: 'aString', type: 'string', i18n: 'aString.label' }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: '' }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: 'Seekra is great!' }],
+
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', options: [
+            { name: 'yes', i18n: 'selectSomething.options.yes' },
+            { name: 'no', i18n: 'selectSomething.options.no' },
+            { name: 'maybe', i18n: 'selectSomething.options.maybe' }
+        ] }],
+
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'no', options: [
+            { name: 'yes', i18n: 'selectSomething.options.yes' },
+            { name: 'no', i18n: 'selectSomething.options.no' },
+            { name: 'maybe', i18n: 'selectSomething.options.maybe' }
+        ] }],
+
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [] }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [
+            { name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true }
+        ] }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [
+            { name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true },
+            { name: 'enableFeature43', type: 'bool', i18n: 'feature.43.enable', default: true }
+        ] }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [
+            { name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true },
+            { name: 'enableFeature43', type: 'bool', i18n: 'feature.43.enable', default: true },
+            { name: 'aSecondSection', type: 'section', i18n: 'sections.aSecondSection.title', content: [
+                { name: 'enableFeature44', type: 'bool', i18n: 'feature.44.enable', default: true },
+            ] }
+        ] }]
+    ])('throws no error for the entry %s', ([ entry ]) => {
+        expect(() => validateEntry(entry)).not.throws(Error);
+    });
+
+    test.for([
+        [{ name: 'enableFeature42', type: 'bool', i18n: '' }],
+        [{ name: 'enableFeature42', type: 'thisTypeDoesNotExistAndHasAVeryLongName', i18n: 'feature.42.enable' }],
+        [{ name: '', type: 'thisTypeDoesNotExistAndHasAVeryLongName', i18n: 'feature.42.enable' }],
+        [{ name: '', type: 'thisTypeDoesNotExistAndHasAVeryLongName', i18n: '' }],
+        [{ name: '', type: 'bool', i18n: '' }],
+        [{ name: '', type: 'bool', i18n: '' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 42 }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: '42' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 'Seekra' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 'true' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 'false' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 'undefined' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: 'null' }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: [] }],
+        [{ name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: {} }],
+        [{ name: 'enableFeature42', type: '', i18n: 'feature.42.enable', default: {} }],
+    
+        [{ name: '', type: 'number', i18n: 'aNumber.label' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: '42' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: 'zero' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: 'undefined' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: 'false' }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: true }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: false }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: [] }],
+        [{ name: 'aNumber', type: 'number', i18n: 'aNumber.label', default: {} }],
+        [{ name: 'aNumber', type: '', i18n: 'aNumber.label', default: {} }],
+        [{ name: 'aNumber', type: '', i18n: 'aNumber.label', default: 42 }],
+    
+        [{ name: 'aString', type: 'string', i18n: '' }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: 42 }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: true }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: false }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: [] }],
+        [{ name: 'aString', type: 'string', i18n: 'aString.label', default: {} }],
+        [{ name: 'aString', type: 'string', i18n: '', default: {} }],
+
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'a', options: true }],
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'a', options: [] }],
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'c', options: [
+            { name: 'a', i18n: 'a' },
+            { name: 'b', i18n: 'b' }
+        ] }],
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'a', options: [
+            { name: 'a', i18n: 'a' },
+            { name: 'b', i18n: '' },
+            { name: 'c' }
+        ] }],
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'a', allowMultiple: 'false', options: [
+            { name: 'a', i18n: 'a' },
+            { name: 'b', i18n: '' },
+            { name: 'c' }
+        ] }],
+
+        [{ name: 'selectSomething', type: 'selection', i18n: 'selectSomething.title', default: 'no', options: [
+            { name: 'yes', i18n: '' },
+            { name: '', i18n: 'selectSomething.options.no' },
+            { name: 'maybe', i18n: 'selectSomething.options.maybe' },
+            { name: '', i18n: '' },
+            { name: 42, i18n: 43 },
+            { name: '' },
+            { i18n: '' },
+            {}
+        ] }],
+
+        [{ name: 'aSection', type: 'section', i18n: '', content: [] }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: '' }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: '[]' }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: 'a' }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [
+            { name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true },
+            { name: 'enableFeature43', type: 'bool', i18n: 'feature.42.enable', default: 0 },
+            { name: 'enableFeature44', type: 'bool' }
+        ] }],
+        [{ name: 'aSection', type: 'section', i18n: 'sections.aSection.title', content: [
+            { name: 'enableFeature42', type: 'bool', i18n: 'feature.42.enable', default: true },
+            { name: 'enableFeature43', type: 'bool', i18n: 'feature.43.enable', default: true },
+            { name: 'aSecondSection', type: 'section', i18n: 'sections.aSecondSection.title', content: 'Hello' },
+            { name: 'aSecondSection', type: 'section', i18n: '', content: [] },
+            { name: 'aSecondSection', type: 'section', i18n: 'i18n', content: [] },
+            { name: 'aSecondSection', type: 'section', content: [] }
+        ] }]
+    ])('throws an error for the entry %s', ([ entry ]) => {
+        expect(() => validateEntry(entry)).throws(Error);
+    });
+});
+
+describe('validateSelectionOptions', () => {
+    test.for([
+        [[{ name: 'test', i18n: 'test.label' }]],
+        [[{ name: 'test', i18n: 'test.label' }, { name: 'test2', i18n: 'test2.label' }]],
+        [[{ name: 'test', i18n: 'test.label' }, { name: 'test', i18n: 'test2.label' }, { name: 'test3', i18n: 'test.label' }]]
+    ])('throws no error for the options %s', ([ options ]) => {
+        expect(() => validateSelectionOptions(options)).not.throws(Error);
+    });
+
+    test.for([
+        [[{}]],
+        [[{ i18n: '' }]],
+        [[{ i18n: 'a' }]],
+        [[{ name: 'a' }]],
+        [[{ name: '' }]],
+        [[{ name: '', i18n: 'test.label' }]],
+        [[{ name: 'test', i18n: '' }]],
+        [[{ name: '', i18n: '' }]],
+        [[{ name: '', i18n: 'test.label' }, { name: 'test2', i18n: '' }]],
+        [[{ name: 'test', i18n: '' }, { name: '', i18n: 'test2.label' }, { name: '', i18n: '  ' }, { name: '42', i18n: '42.i18n' }]],
+        [[]]
+    ])('throws an error for the options %s', ([ options ]) => {
+        expect(() => validateSelectionOptions(options)).throws(Error);
+    });
+});
+
+describe('assertType', () => {
+    test.for([
+        ['bool'],
+        ['number'],
+        ['string'],
+        ['selection'],
+        ['section']
+    ])('throws no error for the value %s', ([ value ]) => {
+        expect(() => assertType(value)).not.throw(Error);
+    });
+
+    test.for([
+        [''],
+        [' '],
+        ['  '],
+        ['   '],
+
+        ['42'],
+        ['0'],
+        ['-42'],
+        ['-42.0'],
+        ['-0.0'],
+
+        ['a'],
+        ['ab'],
+        ['SeekraIsGreat!'],
+        ['Seekra is great!'],
+
+        [undefined],
+        [null]
+    ])('throws an error for the value %s', ([ value ]) => {
+        expect(() => assertType(value)).throw(Error);
+    });
+});
+
+describe('assertString', () => {
+    test.for([
+        ['a'],
+        ['b'],
+        ['ab'],
+
+        ['0'],
+        ['42'],
+
+        ['null'],
+        ['undefined'],
+
+        ['()&%())']
+    ])('throws no error for the value %s', ([ value ]) => {
+        expect(() => assertString(value)).not.throw(Error);
+    });
+
+    test.for([
+        [0],
+        [1],
+        [42],
+        [-1],
+        [-42],
+
+        [''],
+        [' '],
+        ['  '],
+        ['     ']
+    ])('throws an error for the value %s', ([ value ]) => {
+        expect(() => assertString(value)).throws(Error);
+    });
+});

src/features/settings/utils/settingsValidator.js

@@ -16,13 +16,13 @@ limitations under the License.
 
 const VALID_TYPES = ['bool', 'number', 'string', 'selection', 'section'];
 
-function assertString(value, path) {
+export const assertString = function assertString (value, path) {
     if (typeof value !== 'string' || value.trim() === '') {
         throw new Error(`[settings] "${path}" must be a non-empty string`);
     }
 }
 
-function assertType(value, path) {
+export const assertType = function assertType (value, path) {
     if (!VALID_TYPES.includes(value)) {
         throw new Error(
             `[settings] "${path}" has invalid type "${value}". Must be one of: ${VALID_TYPES.join(', ')}`
@@ -30,21 +30,23 @@ function assertType(value, path) {
     }
 }
 
-function validateSelectionOptions(options, path) {
+export const validateSelectionOptions = function validateSelectionOptions (options, path) {
     if (!Array.isArray(options) || options.length === 0) {
         throw new Error(`[settings] "${path}.options" must be a non-empty array`);
-    }
+    };
     options.forEach((opt, i) => {
         assertString(opt.name, `${path}.options[${i}].name`);
         assertString(opt.i18n, `${path}.options[${i}].i18n`);
     });
 }
 
-function validateEntry(entry, path) {
+export const validateEntry = function validateEntry (entry, path) {
     assertType(entry.type, `${path}.type`);
     
+    assertString(entry.name, `${path}.name`);
+    assertString(entry.i18n, `${path}.i18n`);
+
     if (entry.type === 'section') {
-        assertString(entry.name, `${path}.name`);
         if (!Array.isArray(entry.content)) {
             throw new Error(`[settings] "${path}.content" must be an array`);
         }
@@ -54,28 +56,46 @@ function validateEntry(entry, path) {
         return;
     }
     
-    assertString(entry.name, `${path}.name`);
-    assertString(entry.i18n, `${path}.i18n`);
-
+    if (entry.type === 'selection') {
+        validateSelectionOptions(entry.options, path);
+        if (typeof entry.allowMultiple !== 'boolean' && entry.allowMultiple) {
+            throw new Error(`[settings] "${path}.allowMultiple" must be a boolean`);
+        }
+    };
     if (entry.default !== undefined) {
         if (entry.type === 'bool' && typeof entry.default !== 'boolean') {
-             throw new Error(`[settings] "${path}.default" must be a boolean`);
-         }
-         if (entry.type === 'number' && typeof entry.default !== 'number') {
-             throw new Error(`[settings] "${path}.default" must be a number`);
-         }
-         if (entry.type === 'string' && typeof entry.default !== 'string') {
-             throw new Error(`[settings] "${path}.default" must be a string`);
-         }
-         if (entry.type === 'selection') {
-             validateSelectionOptions(entry.options, path);
-             if (typeof entry.allowMultiple !== 'boolean') {
-                 throw new Error(`[settings] "${path}.allowMultiple" must be a boolean`);
-             }
-         }
+            throw new Error(`[settings] "${path}.default" must be a boolean`);
+        }
+        if (entry.type === 'number' && typeof entry.default !== 'number') {
+            throw new Error(`[settings] "${path}.default" must be a number`);
+        }
+        if (entry.type === 'string' && typeof entry.default !== 'string') {
+            throw new Error(`[settings] "${path}.default" must be a string`);
+        }
+        if (entry.type === 'selection') {
+            if (typeof entry.default !== 'string') {
+                throw new Error(`[settings] "${path}.default" must be a string`);
+            };
+            if (!entry.options.map((option) => option.name).includes(entry.default)) {
+                throw new Error(`[settings] option "${path}.default" does not exist`);
+            };
+        };
     }
 }
 
+export const validateFirstLevelSection = function validateFirstLevelSection (section, path) {
+    assertString(section.name);
+    assertString(section.i18n);
+
+    if (!Array.isArray(section.content)) {
+        throw new Error(`[settings] "${path}.content" must be an array`);
+    };
+
+    section.content.forEach((entry, i) =>
+        validateEntry(entry, `${path}.content[${i}]`)
+    );
+};
+
 /**
  * Validates a raw settings config object.
  * @param {unknown} raw
@@ -90,7 +110,7 @@ export function validateSettingsConfig(raw) {
             throw new Error('[settings] "contents" must be an array');
         }
         raw.contents.forEach((entry, i) =>
-            validateEntry(entry, `contents[${i}]`)
+            validateFirstLevelSection(entry, `contents[${i}]`)
         );
         return { valid: true, config: raw };
     } catch (e) {

src/features/settings/views/SettingsView.vue

@@ -17,9 +17,33 @@ limitations under the License.
 <script setup>
 import LeftSidebarLayout from '@/layouts/LeftSidebarLayout.vue';
 
+import { loadSettingsConfig } from '../utils/settingsParser';
+import { onMounted, ref } from 'vue';
 import { useI18n } from 'vue-i18n';
+import { useRoute, useRouter } from 'vue-router';
 
 const { t } = useI18n();
+const route = useRoute();
+const router = useRouter();
+
+const settingsLoaded = ref(false)
+const settings = ref([]);
+
+onMounted(async () => {
+    settings.value = (await loadSettingsConfig()).contents;
+    if (!settings.value.map((section) => section.name).includes(getActiveSection())) {
+        router.push('/settings');
+    };
+    settingsLoaded.value = true;
+});
+
+const getActiveSection = function getActiveSection () {
+    const segments = route.path
+        .split('/')
+        .filter(Boolean);
+
+    return segments[1];
+};
 </script>
 
 <template>
@@ -31,7 +55,23 @@ const { t } = useI18n();
         </header>
         <LeftSidebarLayout class="layout">
             <template #sidebar>
+                <ul class="sidebar-sections-list">
+                    <li v-for="section in settings">
+                        <RouterLink
+                            :to="`/settings/${section.name}`"
+                            class="button button-link link sidebar-section"
+                            :class="{ active: getActiveSection() === section.name }"
+                        >
+                            {{ t(section.i18n) }}
+                        </RouterLink>
+                    </li>
+                </ul>
             </template>
+            <div>
+                <div v-if="!settingsLoaded">
+                    {{ t('loading') }}
+                </div>
+            </div>
         </LeftSidebarLayout>
     </div>
 </template>
@@ -46,6 +86,10 @@ const { t } = useI18n();
     flex-direction: column;
 }
 
+.active {
+    background-color: var(--light-hover);
+}
+
 .header {
     padding: var(--main-content-padding-y) var(--main-content-padding-x);
 }
@@ -53,4 +97,21 @@ const { t } = useI18n();
 .header h1 {
     margin: 0;
 }
+
+.sidebar-sections-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+}
+
+.sidebar-section {
+    --padding: 0.8em;
+    border-radius: var(--padding);
+    padding: var(--padding);
+    margin-bottom: 4px;
+    width: calc(100% - 2 * var(--padding));
+    text-align: start;
+    font-size: 1rem;
+    display: block;
+}
 </style>

src/locales/de.json

@@ -1,4 +1,5 @@
 {
+    "loading": "Laden ...",
     "search": {
         "searchBar": {
             "submit": "Suchen",

src/locales/en.json

@@ -1,4 +1,5 @@
 {
+    "loading": "Loading ...",
     "search": {
         "searchBar": {
             "submit": "Search",

src/locales/es.json

@@ -1,4 +1,5 @@
 {
+    "loading": "Cargando ...",
     "search": {
         "searchBar": {
             "submit": "Buscar",

src/locales/fr.json

@@ -1,4 +1,5 @@
 {
+    "loading": "Chargement ...",
     "search": {
         "searchBar": {
             "submit": "Rechercher",

src/locales/it.json

@@ -1,4 +1,5 @@
 {
+    "loading": "Caricamento ...",
     "search": {
         "searchBar": {
             "submit": "Cerca",

src/locales/pt.json

@@ -1,4 +1,5 @@
 {
+    "loading": "A carregar ...",
     "search": {
         "searchBar": {
             "submit": "Pesquisar",

src/router/index.js

@@ -43,6 +43,12 @@ const routes = [
         path: '/settings',
         name: 'settings',
         component: SettingsView,
+        children: [
+            {
+                path: ':rest(.*)',
+                component: SettingsView
+            }
+        ],
         meta: {
             title: () => i18n.global.t('preferences.settings')
         }
@@ -59,6 +65,18 @@ const router = createRouter({
     routes
 });
 
+// remove trailing slash(es)
+router.beforeEach((route) => {
+    if (route.path !== '/' && route.path.endsWith('/')) {
+        return {
+            path: route.path.replace(/\/+$/, ''),
+            query: route.query,
+            hash: route.hash,
+            replace: true
+        };
+    };
+});
+
 // set page title
 router.afterEach(to => {
     const title =

src/styles/common.css

@@ -23,10 +23,23 @@ body {
     text-decoration: none;
 }
 
-.link:hover:not(.button-link) {
+.link:hover:not(.button-link), .link:focus:not(.button-link) {
+    outline: none;
     text-decoration: underline;
 }
 
+.button-link {
+    color: var(--dark);
+}
+
+.button-link:hover {
+    color: var(--dark);
+}
+
+.button-link:visited {
+    color: var(--dark);
+}
+
 input {
     color: var(--dark);
 }
@@ -35,3 +48,17 @@ input {
     padding: var(--main-content-padding);
     width: calc(100% - var(--main-content-padding-x) * 2);
 }
+
+.button {
+    background-color: var(--light-bg);
+    border: none;
+}
+
+.button:focus {
+    background-color: var(--light-hover);
+    outline: none;
+}
+
+.button:hover {
+    background-color: var(--light-hover);
+}

src/views/NotFound.vue

@@ -43,7 +43,7 @@ const { t } = useI18n();
 .error-message{
     margin: 0;
     font-weight: 600;
-    font-size: 2vw;
+    font-size: 1.75rem;
 }
 #link {
     align-items: center;