> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rtfm.guide/llms.txt
> Use this file to discover all available pages before exploring further.

# Preferences

> Customize your RTFM.guide experience

## Accessing Preferences

Manage your preferences at [https://rtfm.guide/settings](https://rtfm.guide/settings)

Settings are organized into categories:

* Profile
* Password
* Appearance
* Two-Factor Authentication (coming soon)
* Notifications (coming soon)

## Appearance Settings

### Theme

Choose your preferred visual theme:

<CardGroup cols={2}>
  <Card title="Light Mode" icon="sun">
    Clean, bright interface perfect for daytime use
  </Card>

  <Card title="Dark Mode" icon="moon">
    Easy on the eyes for night coding sessions
  </Card>
</CardGroup>

Access at [https://rtfm.guide/settings/appearance](https://rtfm.guide/settings/appearance)

**Coming soon**: Auto theme (follows system preference)

### Content Mode

Control content filtering:

| Mode     | Description                                                        |
| -------- | ------------------------------------------------------------------ |
| **SFW**  | Family-friendly content only. Filters profanity and mature content |
| **NSFW** | All content visible, including casual language and mature topics   |

<Info>
  **Why content modes?** Some guides use casual or colorful language. SFW mode ensures a professional environment, while NSFW mode shows unfiltered content.
</Info>

## Profile Settings

Access at [https://rtfm.guide/settings/profile](https://rtfm.guide/settings/profile)

### Basic Information

* **Name**: Your display name across the site
* **Email**: For login and notifications
* **Bio**: Short description about you (coming soon)
* **Location**: Where you're based (coming soon)
* **Website**: Your personal or portfolio site (coming soon)

### Avatar (Coming Soon)

* Upload custom image
* Use Gravatar
* Choose default avatar style

### Social Links (Coming Soon)

Add your profiles:

* GitHub
* Twitter/X
* LinkedIn
* Personal blog

## Password Settings

Access at [https://rtfm.guide/settings/password](https://rtfm.guide/settings/password)

### Change Password

1. Enter current password
2. Enter new password
3. Confirm new password
4. Save changes

**Requirements**:

* Minimum 8 characters
* At least one letter
* At least one number (recommended)
* At least one special character (recommended)

<Tip>
  **Password best practices**: Use a unique password you don't use elsewhere. Consider a password manager.
</Tip>

## Two-Factor Authentication

Access at [https://rtfm.guide/settings/two-factor](https://rtfm.guide/settings/two-factor) (coming soon)

### Enable 2FA

Protect your account with two-factor authentication:

<Steps>
  <Step title="Enable 2FA">
    Click "Enable Two-Factor Authentication"
  </Step>

  <Step title="Scan QR Code">
    Use an authenticator app to scan the QR code
  </Step>

  <Step title="Enter Code">
    Enter the 6-digit code from your app
  </Step>

  <Step title="Save Recovery Codes">
    Download and store your recovery codes safely
  </Step>
</Steps>

### Supported Authenticator Apps

* Google Authenticator
* Authy
* 1Password
* Any TOTP-compatible app

### Recovery Codes

* 10 single-use codes provided
* Store them safely offline
* Use if you lose access to your authenticator
* Generate new codes anytime

## Notification Preferences (Coming Soon)

Control what notifications you receive:

### Email Notifications

* New comments on your guides
* Reactions received
* @mentions
* System announcements
* Weekly digest

### Push Notifications

* Browser push notifications
* Desktop notifications
* Sound alerts

### Frequency

* Real-time (immediate)
* Daily digest
* Weekly digest
* Off

## Privacy Settings (Coming Soon)

Control your privacy:

### Profile Visibility

* Public (anyone can see)
* Members only (logged-in users)
* Private (only you)

### Activity

* Show guides on profile
* Show saved guides
* Show comment history
* Show reactions

### Data Export

* Export all your data
* Download guides as Markdown
* Export comments
* Export saved guides

### Account Deletion

Delete your account and all associated data.

<Warning>
  **Account deletion is permanent**: All your guides, comments, and data will be permanently deleted. This cannot be undone.
</Warning>

## Preference Persistence

Your preferences are:

* Saved automatically when changed
* Synced across devices
* Stored securely server-side
* Applied immediately

### Browser Preferences

Some preferences stored locally:

* Theme choice (also in database)
* Content mode (also in database)
* UI state (sidebar, etc.)

## Resetting Preferences

To reset all preferences to default:

1. Go to Settings
2. Scroll to bottom
3. Click "Reset to Defaults"
4. Confirm

## Coming Soon

* **Reading preferences**: Font size, line spacing
* **Editor preferences**: Default visibility, autosave interval
* **Email preferences**: Digest timing, template style
* **Advanced settings**: API access, webhooks
* **Accessibility**: High contrast, reduced motion