Skip to content

Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.

Add generic settings overview page (#2462)

Leendert de Borst556dcbff10ba
diff --git a/apps/web/src/pages/settings/General.tsx b/apps/web/src/pages/settings/General.tsx
index a2f7bac44..d182d9a92 100644
--- a/apps/web/src/pages/settings/General.tsx
+++ b/apps/web/src/pages/settings/General.tsx
@@ -1,13 +1,11 @@
-import { getIdentityAgeRanges, getIdentityLanguages } from '@aliasvault/client/rust/RustCore';
-import { getLanguageInfo, resolveDefaultLanguage } from '@aliasvault/i18n/languages';
import React, { useCallback, useEffect, useState } from 'react';
import { useTranslation } from 'react-i18next';
-import DefaultPasswordSettings from '@/components/settings/DefaultPasswordSettings';
+import SettingsPageHeader from '@/components/settings/SettingsPageHeader';
import Card from '@/components/shared/Card';
import FormLabel from '@/components/shared/FormLabel';
import PageContent from '@/components/shared/PageContent';
-import PageHeader from '@/components/shared/PageHeader';
+import SectionTitle from '@/components/shared/SectionTitle';
import Select from '@/components/shared/Select';
import { getAppConfig } from '@/config/AppConfig';
import { useDb } from '@/context/DbContext';
@@ -36,13 +34,7 @@ const GeneralSettings: React.FC = () => {
const [publicDomains, setPublicDomains] = useState<string[]>([]);
const [defaultEmailDomain, setDefaultEmailDomain] = useState('');
const [autoEmailRefresh, setAutoEmailRefresh] = useState(true);
- const [identityLanguages, setIdentityLanguages] = useState<string[]>([]);
- const [ageRanges, setAgeRanges] = useState<string[]>([]);
- const [identityLanguage, setIdentityLanguage] = useState('');
- const [identityGender, setIdentityGender] = useState('random');
- const [identityAgeRange, setIdentityAgeRange] = useState('random');
const [appLanguage, setAppLanguage] = useState(i18n.language);
- const [clipboardClearSeconds, setClipboardClearSeconds] = useState('10');
/**
* Write a vault setting and push it.
@@ -53,14 +45,6 @@ const GeneralSettings: React.FC = () => {
});
}, [dbContext.sqliteClient, executeVaultMutationInBackground]);
- /**
- * The identity language: the explicit setting, or the one matching the UI language.
- */
- const resolveIdentityLanguage = useCallback((languages: string[]): string => {
- const explicit = dbContext.sqliteClient?.settings.getDefaultIdentityLanguage() ?? '';
- return explicit.trim().length > 0 ? explicit : resolveDefaultLanguage(i18n.language, languages);
- }, [dbContext.sqliteClient, i18n.language]);
-
useEffect(() => {
const client = dbContext.sqliteClient;
if (!client) {
@@ -69,15 +53,13 @@ const GeneralSettings: React.FC = () => {
let cancelled = false;
/**
- * Load the domains and the current settings.
+ * Load the email domains and the current settings.
*/
const load = async (): Promise<void> => {
const metadata = await vaultStore.getVaultMetadata();
const hidden = metadata?.hiddenPrivateEmailDomains ?? getAppConfig().hiddenPrivateEmailDomains;
const privateList = (metadata?.privateEmailDomains ?? getAppConfig().privateEmailDomains).filter(d => !hidden.includes(d));
const publicList = metadata?.publicEmailDomains ?? [];
- const languages = (await getIdentityLanguages()).sort((a, b) => getLanguageInfo(a).label.localeCompare(getLanguageInfo(b).label));
- const ranges = await getIdentityAgeRanges();
if (cancelled) {
return;
}
@@ -90,36 +72,29 @@ const GeneralSettings: React.FC = () => {
}
setDefaultEmailDomain(domain);
setAutoEmailRefresh(client.settings.getSetting('AutoEmailRefresh', 'True').toLowerCase() === 'true');
- setIdentityLanguages(languages);
- setAgeRanges(ranges);
- setIdentityLanguage(resolveIdentityLanguage(languages));
- setIdentityGender(client.settings.getDefaultIdentityGender());
- setIdentityAgeRange(client.settings.getDefaultIdentityAgeRange());
- setClipboardClearSeconds(client.settings.getSetting('ClipboardClearSeconds', '10'));
};
void load();
return (): void => {
cancelled = true;
};
- }, [dbContext.sqliteClient, resolveIdentityLanguage]);
+ }, [dbContext.sqliteClient]);
/**
- * Switch the UI language, remembered in the vault and locally, and refresh the derived identity language.
+ * Switch the UI language, remembered in the vault and locally.
*/
const updateAppLanguage = async (code: string): Promise<void> => {
setAppLanguage(code);
await changeLanguage(code);
await updateSetting('AppLanguage', code);
- setIdentityLanguage(resolveIdentityLanguage(identityLanguages));
};
return (
<>
- <PageHeader breadcrumbItems={[{ displayName: t('settings.general.pageTitle') }]} title={t('settings.general.pageTitle')} description={t('settings.general.pageDescription')} />
+ <SettingsPageHeader icon="general" title={t('settings.general.pageTitle')} description={t('settings.general.pageDescription')} />
<PageContent>
<Card>
- <h3 className="mb-4 text-lg font-medium text-gray-900 dark:text-white">{t('settings.general.appLanguageTitle')}</h3>
+ <SectionTitle className="mb-4">{t('settings.general.appLanguageTitle')}</SectionTitle>
<div className="mb-4">
<FormLabel htmlFor="appLanguage">{t('settings.language')}</FormLabel>
<Select id="appLanguage" value={appLanguage} onChange={e => void updateAppLanguage(e.target.value)}>
@@ -130,7 +105,7 @@ const GeneralSettings: React.FC = () => {
</Card>
<Card>
- <h3 className="mb-4 text-lg font-medium text-gray-900 dark:text-white">{t('settings.general.emailSettingsTitle')}</h3>
+ <SectionTitle className="mb-4">{t('settings.general.emailSettingsTitle')}</SectionTitle>
<div className="mb-4">
<FormLabel htmlFor="defaultEmailDomain">{t('settings.general.defaultEmailDomainLabel')}</FormLabel>
<Select id="defaultEmailDomain" value={defaultEmailDomain} onChange={(e) => {
@@ -160,69 +135,6 @@ const GeneralSettings: React.FC = () => {
</div>
</Card>
- <Card>
- <h3 className="mb-4 text-lg font-medium text-gray-900 dark:text-white">{t('settings.general.aliasSettingsTitle')}</h3>
-
- <div className="mb-4">
- <FormLabel htmlFor="defaultIdentityLanguage">{t('settings.language')}</FormLabel>
- <Select id="defaultIdentityLanguage" value={identityLanguage} onChange={(e) => {
- setIdentityLanguage(e.target.value);
- void updateSetting('DefaultIdentityLanguage', e.target.value);
- }}>
- {identityLanguages.map(code => <option key={code} value={code}>{getLanguageInfo(code).flag} {getLanguageInfo(code).label}</option>)}
- </Select>
- <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationLanguageDescription')}</span>
- </div>
-
- <div className="mb-4">
- <FormLabel htmlFor="defaultIdentityGender">{t('fieldLabels.alias.gender')}</FormLabel>
- <Select id="defaultIdentityGender" value={identityGender} onChange={(e) => {
- setIdentityGender(e.target.value);
- void updateSetting('DefaultIdentityGender', e.target.value);
- }}>
- <option value="random">{t('settings.identityGeneratorSettings.genderOptions.random')}</option>
- <option value="male">{t('settings.identityGeneratorSettings.genderOptions.male')}</option>
- <option value="female">{t('settings.identityGeneratorSettings.genderOptions.female')}</option>
- </Select>
- <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationGenderDescription')}</span>
- </div>
-
- <div className="mb-4">
- <FormLabel htmlFor="defaultIdentityAgeRange">{t('settings.identityGeneratorSettings.ageRangeSection')}</FormLabel>
- <Select id="defaultIdentityAgeRange" value={identityAgeRange} onChange={(e) => {
- setIdentityAgeRange(e.target.value);
- void updateSetting('DefaultIdentityAgeRange', e.target.value);
- }}>
- {ageRanges.map(range => <option key={range} value={range}>{range === 'random' ? t('settings.identityGeneratorSettings.genderOptions.random') : range}</option>)}
- </Select>
- <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationAgeRangeDescription')}</span>
- </div>
- </Card>
-
- <Card>
- <h3 className="mb-4 text-lg font-medium text-gray-900 dark:text-white">{t('settings.clipboardSettings')}</h3>
- <div className="mb-4">
- <FormLabel htmlFor="clipboardClearSeconds">{t('settings.general.clipboardClearSecondsLabel')}</FormLabel>
- <Select id="clipboardClearSeconds" value={clipboardClearSeconds} onChange={(e) => {
- setClipboardClearSeconds(e.target.value);
- void updateSetting('ClipboardClearSeconds', e.target.value);
- }}>
- <option value="0">{t('common.disabled')}</option>
- <option value="5">{t('common.duration.5seconds')}</option>
- <option value="10">{t('settings.clipboardClearOptions.10seconds')}</option>
- <option value="15">{t('common.duration.15seconds')}</option>
- </Select>
- <span className="block text-sm font-normal text-gray-500 dark:text-gray-400">{t('settings.general.clipboardClearSecondsDescription')}</span>
- <div className="mt-2 p-3 bg-yellow-50 border border-yellow-200 rounded-lg dark:bg-yellow-900/20 dark:border-yellow-800">
- <p className="text-sm text-yellow-800 dark:text-yellow-200">{t('settings.general.clipboardClearLimitationNote')}</p>
- </div>
- </div>
- </Card>
-
- <Card>
- <h3 className="mb-4 text-lg font-medium text-gray-900 dark:text-white">{t('items.passwordSettings')}</h3>
- <DefaultPasswordSettings />
- </Card>
</PageContent>
</>
);
diff --git a/apps/web/src/pages/settings/IdentityGenerator.tsx b/apps/web/src/pages/settings/IdentityGenerator.tsx
new file mode 100644
index 000000000..fbf3120e1
--- /dev/null
+++ b/apps/web/src/pages/settings/IdentityGenerator.tsx
@@ -0,0 +1,117 @@
+import { getIdentityAgeRanges, getIdentityLanguages } from '@aliasvault/client/rust/RustCore';
+import { getLanguageInfo, resolveDefaultLanguage } from '@aliasvault/i18n/languages';
+import React, { useCallback, useEffect, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+
+import SettingsPageHeader from '@/components/settings/SettingsPageHeader';
+import Card from '@/components/shared/Card';
+import FormLabel from '@/components/shared/FormLabel';
+import PageContent from '@/components/shared/PageContent';
+import Select from '@/components/shared/Select';
+import { useDb } from '@/context/DbContext';
+import { usePageTitle } from '@/hooks/usePageTitle';
+import { useVaultMutate } from '@/hooks/useVaultMutate';
+
+/**
+ * The identity generator settings page: defaults for newly generated identities.
+ */
+const IdentityGeneratorSettings: React.FC = () => {
+ const { t, i18n } = useTranslation();
+ const dbContext = useDb();
+ const { executeVaultMutationInBackground } = useVaultMutate();
+
+ usePageTitle(t('settings.identityGenerator'));
+
+ const [identityLanguages, setIdentityLanguages] = useState<string[]>([]);
+ const [ageRanges, setAgeRanges] = useState<string[]>([]);
+ const [identityLanguage, setIdentityLanguage] = useState('');
+ const [identityGender, setIdentityGender] = useState('random');
+ const [identityAgeRange, setIdentityAgeRange] = useState('random');
+
+ /**
+ * Write a vault setting and push it.
+ */
+ const updateSetting = useCallback(async (key: string, value: string): Promise<void> => {
+ await executeVaultMutationInBackground(async () => {
+ dbContext.sqliteClient?.settings.updateSetting(key, value);
+ });
+ }, [dbContext.sqliteClient, executeVaultMutationInBackground]);
+
+ useEffect(() => {
+ const client = dbContext.sqliteClient;
+ if (!client) {
+ return;
+ }
+ let cancelled = false;
+
+ /**
+ * Load the identity options and the current settings.
+ */
+ const load = async (): Promise<void> => {
+ const languages = (await getIdentityLanguages()).sort((a, b) => getLanguageInfo(a).label.localeCompare(getLanguageInfo(b).label));
+ const ranges = await getIdentityAgeRanges();
+ if (cancelled) {
+ return;
+ }
+
+ // The identity language: the explicit setting, or the one matching the UI language.
+ const explicit = client.settings.getDefaultIdentityLanguage();
+ setIdentityLanguages(languages);
+ setAgeRanges(ranges);
+ setIdentityLanguage(explicit.trim().length > 0 ? explicit : resolveDefaultLanguage(i18n.language, languages));
+ setIdentityGender(client.settings.getDefaultIdentityGender());
+ setIdentityAgeRange(client.settings.getDefaultIdentityAgeRange());
+ };
+ void load();
+ return (): void => {
+ cancelled = true;
+ };
+ }, [dbContext.sqliteClient, i18n.language]);
+
+ return (
+ <>
+ <SettingsPageHeader icon="identityGenerator" title={t('settings.identityGenerator')} description={t('settings.identityGeneratorSettings.description')} />
+
+ <PageContent>
+ <Card>
+ <div className="mb-4">
+ <FormLabel htmlFor="defaultIdentityLanguage">{t('settings.language')}</FormLabel>
+ <Select id="defaultIdentityLanguage" value={identityLanguage} onChange={(e) => {
+ setIdentityLanguage(e.target.value);
+ void updateSetting('DefaultIdentityLanguage', e.target.value);
+ }}>
+ {identityLanguages.map(code => <option key={code} value={code}>{getLanguageInfo(code).flag} {getLanguageInfo(code).label}</option>)}
+ </Select>
+ <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationLanguageDescription')}</span>
+ </div>
+
+ <div className="mb-4">
+ <FormLabel htmlFor="defaultIdentityGender">{t('fieldLabels.alias.gender')}</FormLabel>
+ <Select id="defaultIdentityGender" value={identityGender} onChange={(e) => {
+ setIdentityGender(e.target.value);
+ void updateSetting('DefaultIdentityGender', e.target.value);
+ }}>
+ <option value="random">{t('settings.identityGeneratorSettings.genderOptions.random')}</option>
+ <option value="male">{t('settings.identityGeneratorSettings.genderOptions.male')}</option>
+ <option value="female">{t('settings.identityGeneratorSettings.genderOptions.female')}</option>
+ </Select>
+ <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationGenderDescription')}</span>
+ </div>
+
+ <div className="mb-4">
+ <FormLabel htmlFor="defaultIdentityAgeRange">{t('settings.identityGeneratorSettings.ageRangeSection')}</FormLabel>
+ <Select id="defaultIdentityAgeRange" value={identityAgeRange} onChange={(e) => {
+ setIdentityAgeRange(e.target.value);
+ void updateSetting('DefaultIdentityAgeRange', e.target.value);
+ }}>
+ {ageRanges.map(range => <option key={range} value={range}>{range === 'random' ? t('settings.identityGeneratorSettings.genderOptions.random') : range}</option>)}
+ </Select>
+ <span className="block text-sm font-normal text-gray-500 truncate dark:text-gray-400">{t('settings.general.aliasGenerationAgeRangeDescription')}</span>
+ </div>
+ </Card>
+ </PageContent>
+ </>
+ );
+};
+
+export default IdentityGeneratorSettings;
diff --git a/apps/web/src/pages/settings/Settings.tsx b/apps/web/src/pages/settings/Settings.tsx
new file mode 100644
index 000000000..64576dadf
--- /dev/null
+++ b/apps/web/src/pages/settings/Settings.tsx
@@ -0,0 +1,145 @@
+import { AppInfo } from '@aliasvault/client/platform/AppInfo';
+import { familySharingText } from '@aliasvault/client/sharing/FamilySharingView';
+import { CapabilityKeys } from '@aliasvault/models/webapi';
+import React from 'react';
+import { useTranslation } from 'react-i18next';
+import { Link } from 'react-router-dom';
+
+import SettingsIcon, { type SettingsIconName } from '@/components/settings/SettingsIcon';
+import PageContent from '@/components/shared/PageContent';
+import PageHeader from '@/components/shared/PageHeader';
+import { useAuth } from '@/context/AuthContext';
+import { useCapabilities } from '@/context/CapabilityContext';
+import { useConfirmLogout } from '@/hooks/useConfirmLogout';
+import { usePageTitle } from '@/hooks/usePageTitle';
+
+/**
+ * One row on the settings overview: a link to a settings page.
+ */
+type SettingsRow = {
+ label: string;
+ description: string;
+ icon: SettingsIconName;
+ to: string;
+};
+
+/**
+ * A titled group of rows on the settings overview.
+ */
+type SettingsGroup = {
+ title: string;
+ rows: SettingsRow[];
+};
+
+/**
+ * The content of a row: icon, title and a short description.
+ */
+const RowContent: React.FC<{ row: SettingsRow }> = ({ row }) => (
+ <>
+ <SettingsIcon name={row.icon} className="flex-shrink-0 w-5 h-5 mt-0.5 text-primary-600 dark:text-primary-400" />
+ <span className="min-w-0">
+ <span className="block text-sm font-medium text-gray-900 dark:text-white">{row.label}</span>
+ <span className="block text-xs text-gray-500 dark:text-gray-400 line-clamp-2" title={row.description}>{row.description}</span>
+ </span>
+ </>
+);
+
+/**
+ * One row, linking to its settings page.
+ */
+const Row: React.FC<{ row: SettingsRow }> = ({ row }) => (
+ <Link to={row.to} className="flex items-start gap-3 w-full px-4 py-2.5 text-left hover:bg-gray-50 dark:hover:bg-gray-700/60 transition-colors"><RowContent row={row} /></Link>
+);
+
+/**
+ * Settings overview: the same groups and order as the browser extension and mobile app settings.
+ */
+const Settings: React.FC = () => {
+ const { t } = useTranslation();
+ const { username } = useAuth();
+ const hasCapability = useCapabilities();
+ const confirmLogout = useConfirmLogout();
+
+ usePageTitle(t('common.settings'));
+
+ const groups: SettingsGroup[] = [
+ {
+ title: t('settings.security'),
+ rows: [
+ { to: '/settings/two-factor', label: t('common.twoFactorAuthentication'), description: t('settings.securitySettings.enable2fa.pageDescription'), icon: 'twoFactor' },
+ { to: '/settings/sessions', label: t('settings.sessionsAndLogs'), description: t('settings.sessionsAndLogsDescription'), icon: 'sessions' },
+ { to: '/settings/security', label: t('settings.securitySettings.pageTitle'), description: t('settings.securitySettings.description'), icon: 'security' },
+ ],
+ },
+ {
+ title: t('settings.groups.generators'),
+ rows: [
+ { to: '/settings/password-generator', label: t('settings.passwordGenerator'), description: t('settings.passwordGeneratorSettings.description'), icon: 'passwordGenerator' },
+ { to: '/settings/identity-generator', label: t('settings.identityGenerator'), description: t('settings.identityGeneratorSettings.description'), icon: 'identityGenerator' },
+ ],
+ },
+ {
+ title: t('navigation.vault'),
+ rows: [
+ { to: '/settings/import-export', label: t('settings.importExport'), description: t('importExport.pageDescription'), icon: 'importExport' },
+ { to: '/settings/storage-insights', label: t('settings.storageInsights.breadcrumbTitle'), description: t('settings.storageInsights.pageDescription'), icon: 'storage' },
+ ],
+ },
+ {
+ title: t('settings.groups.general'),
+ rows: [
+ { to: '/settings/general', label: t('settings.general.pageTitle'), description: t('settings.general.pageDescription'), icon: 'general' },
+ { to: '/settings/apps', label: t('settings.apps.pageTitle'), description: t('settings.apps.pageDescription'), icon: 'apps' },
+ ],
+ },
+ ];
+
+ return (
+ <>
+ <PageHeader breadcrumbItems={[{ displayName: t('common.settings') }]} title={t('common.settings')} />
+
+ <PageContent>
+ <div className="px-4 space-y-4">
+ <section className="flex flex-col sm:flex-row sm:items-center gap-3 p-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 dark:bg-gray-800">
+ <div className="flex items-center gap-3 min-w-0 flex-1">
+ <div className="flex-shrink-0 w-10 h-10 rounded-full bg-primary-100 dark:bg-primary-900 flex items-center justify-center">
+ <span className="text-primary-600 dark:text-primary-400 text-lg font-medium">{username?.[0]?.toUpperCase() ?? '?'}</span>
+ </div>
+ <div className="min-w-0">
+ <p className="font-medium text-gray-900 dark:text-white truncate">{username}</p>
+ <p className="text-sm text-gray-500 dark:text-gray-400">{t('common.loggedIn')}</p>
+ </div>
+ </div>
+ <div className="flex flex-wrap gap-2">
+ {hasCapability(CapabilityKeys.VaultSharing) && (
+ <Link to="/settings/family-sharing" className="inline-flex items-center px-3 py-2 text-sm font-medium rounded-lg text-gray-700 bg-gray-100 hover:bg-gray-200 dark:text-gray-200 dark:bg-gray-700 dark:hover:bg-gray-600">
+ <SettingsIcon name="familySharing" className="w-4 h-4 mr-2" />
+ {familySharingText.title}
+ <span className="ml-2 px-1.5 py-0.5 text-[10px] font-semibold uppercase rounded bg-primary-100 text-primary-800 dark:bg-primary-900 dark:text-primary-200">{familySharingText.beta}</span>
+ </Link>
+ )}
+ <button type="button" id="logoutButton" onClick={() => void confirmLogout()} className="inline-flex items-center px-3 py-2 text-sm font-medium rounded-lg text-red-600 bg-red-50 hover:bg-red-100 dark:text-red-400 dark:bg-red-900/30 dark:hover:bg-red-900/50">
+ {t('web.topMenu.logOut')}
+ </button>
+ </div>
+ </section>
+
+ <div className="grid grid-cols-1 md:grid-cols-2 gap-4 items-start">
+ {groups.map((group) => (
+ <section key={group.title} className="bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 dark:bg-gray-800 overflow-hidden">
+ <h2 className="px-4 pt-3 pb-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">{group.title}</h2>
+ <div>
+ {group.rows.map((row) => <Row key={row.label} row={row} />)}
+ </div>
+ </section>
+ ))}
+ </div>
+
+ <p className="text-center text-[13px] text-gray-400 dark:text-gray-500"><span className="font-bold">{t('settings.appVersion')}:</span> {AppInfo.VERSION}</p>
+ </div>
+ </PageContent>
+ </>
+ );
+};
+
+export default Settings;