Privacy-first password manager with built-in email aliasing. Fully encrypted and self-hostable.
import { SharingService } from '@aliasvault/client/sharing/SharingService';
import { sharingText } from '@aliasvault/client/sharing/SharingView';
import { CapabilityKeys } from '@aliasvault/models/webapi';
import React, { useEffect, useState } from 'react';
import { useTranslation } from 'react-i18next';
import { Link } from 'react-router-dom';
import AccountFingerprint from '@/components/settings/AccountFingerprint';
import SettingsIcon, { type SettingsIconName } from '@/components/settings/SettingsIcon';
import PageContent from '@/components/shared/PageContent';
import PageHeader from '@/components/shared/PageHeader';
import { useAccountReminders } from '@/context/AccountReminderContext';
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;
danger?: boolean;
reminder?: boolean;
};
/**
* A group of rows on the settings overview, with an optional title.
*/
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 ${row.danger ? 'text-red-600 dark:text-red-400' : 'text-primary-600 dark:text-primary-400'}`} />
<span className="min-w-0 flex-1">
<span className={`block text-base font-medium ${row.danger ? 'text-red-600 dark:text-red-400' : 'text-gray-900 dark:text-white'}`}>{row.label}</span>
<span className="block text-sm text-gray-500 dark:text-gray-400 line-clamp-2" title={row.description}>{row.description}</span>
</span>
{row.reminder && <span className="flex-shrink-0 w-2 h-2 mt-2 rounded-full bg-primary-500" aria-hidden="true" />}
</>
);
/**
* 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-3 text-left hover:bg-gray-50 dark:hover:bg-gray-700/60 transition-colors"><RowContent row={row} /></Link>
);
/**
* A card holding one group of rows.
*/
const Group: React.FC<{ group: SettingsGroup; className?: string }> = ({ group, className = '' }) => (
<section className={`bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 dark:bg-gray-800 overflow-hidden ${className}`.trim()}>
{group.title && <h2 className="px-4 pt-3 pb-2.5 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">{group.title}</h2>}
<div className="divide-y divide-gray-200 dark:divide-gray-700">
{group.rows.map((row) => <Row key={row.label} row={row} />)}
</div>
</section>
);
/**
* Settings overview.
*/
const Settings: React.FC = () => {
const { t } = useTranslation();
const { username } = useAuth();
const hasCapability = useCapabilities();
const [ownFingerprint, setOwnFingerprint] = useState<string | null>(null);
useEffect(() => {
void SharingService.ownAccountFingerprint().then(setOwnFingerprint);
}, []);
const confirmLogout = useConfirmLogout();
const { reminders } = useAccountReminders();
usePageTitle(t('common.settings'));
const security: SettingsGroup = {
title: t('settings.security'),
rows: [
{ to: '/settings/security/change-password', label: t('settings.securitySettings.changeMasterPassword'), description: t('settings.securitySettings.changePassword.description'), icon: 'changePassword' },
{ to: '/settings/two-factor', label: t('common.twoFactorAuthentication'), description: t('settings.securitySettings.enable2fa.pageDescription'), icon: 'twoFactor', reminder: reminders.enableTwoFactor },
{ to: '/settings/sessions', label: t('settings.sessionsAndLogs'), description: t('settings.sessionsAndLogsDescription'), icon: 'sessions' },
{ to: '/settings/security/vault-unlock', label: t('settings.vaultUnlock'), description: t('settings.vaultUnlockSettings.description'), icon: 'vaultUnlock' },
{ to: '/settings/security/clipboard', label: t('settings.clipboardClear'), description: t('settings.clipboardClearDescription'), icon: 'clipboard' },
],
};
const dangerZone: SettingsGroup = {
rows: [
{ to: '/settings/security/delete-account', label: t('settings.securitySettings.deleteAccount.deleteAccount'), description: t('settings.securitySettings.deleteAccountSection.description'), icon: 'deleteAccount', danger: true },
],
};
const generators: SettingsGroup = {
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' },
],
};
const vault: SettingsGroup = {
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' },
],
};
const general: SettingsGroup = {
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' },
],
};
const preferences: SettingsGroup[] = [generators, vault, general];
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">
<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">
<SettingsIcon name="logout" className="w-4 h-4 mr-2" />
{t('web.topMenu.logOut')}
</button>
</div>
</section>
{/* The account fingerprint someone who shares a folder with this account needs to invite it. */}
{hasCapability(CapabilityKeys.VaultSharing) && ownFingerprint && (
<section className="flex flex-col gap-2 p-4 bg-white border border-gray-200 rounded-lg shadow-sm dark:border-gray-700 dark:bg-gray-800">
<AccountFingerprint id="own-account-fingerprint" code={ownFingerprint} className="self-start" />
<p className="text-sm text-gray-500 dark:text-gray-400">{sharingText.yourFingerprintSettingsHint}</p>
</section>
)}
<div className="grid grid-cols-1 md:grid-cols-2 md:grid-rows-[auto_1fr] gap-4 items-start">
<Group group={security} className="md:col-start-1 md:row-start-1" />
<div className="space-y-4 md:col-start-2 md:row-start-1 md:row-span-2">
{preferences.map((group) => <Group key={group.title} group={group} />)}
</div>
<Group group={dangerZone} className="md:col-start-1 md:row-start-2" />
</div>
</div>
</PageContent>
</>
);
};
export default Settings;