🎨 Personalization & Preferences

This page outlines the customization options available in the EVE Companion App, including themes, layout preferences, pinned tools, and saved user settings. These preferences are stored locally and automatically restored between sessions.

---

🎯 Goals

• Let users personalize visual themes and window layouts
• Persist user settings across app launches
• Offer empire-specific UI styling
• Support modular tool pinning and layout presets

---

🧩 Personalization Features

Feature	Description
Theme Selector	Choose between empire skins or custom dark/light modes
Layout Memory	Save/restore window positions and visibility
Tool Pinning	Always open specific modules at launch
Saved Preferences	Store view settings, sort orders, selected character, etc.
Window Config	Customize size, stack order, minimize/maximize state

---

🎨 Themes & Skins

Available themes:

• Amarr: gold & marble with ornate borders
• Caldari: brushed steel, clipped corners
• Gallente: green/organic, scoop shapes
• Minmatar: oxidized metal, rugged rects
• System: dark/light with accent overrides

Users can select themes via UI dropdown or toggle (data-bs-theme, data-ui-empire).

---

💾 Settings Storage

Preferences are saved to electron-store, such as:

{
  "ui": {
    "theme": "amarr",
    "layout": {
      "Mail": { "x": 100, "y": 200, "open": true },
      "Fleet": { "x": 500, "y": 150, "open": false }
    },
    "startupTools": ["Mail", "Wallet"]
  }
}

---

🖼 Layout Management

Window positions are tracked using interact.js and saved on move/resize. Tool visibility state is updated on open/close and persisted.

Planned: layout presets (e.g., "Scout Mode", "Industrial Ops")

---

⚙️ Interface Pattern

<settings-panel>
  <theme-selector></theme-selector>
  <startup-tool-pins></startup-tool-pins>
  <layout-reset-button></layout-reset-button>
</settings-panel>

---

📡 Planned Enhancements

• Import/export settings as JSON profiles
• Per-character overrides (different layout per toon)
• Keyboard shortcuts & hotkey manager
• Accessibility settings (font scaling, contrast mode)

---

📌 Summary

• Preferences are stored locally and restored on startup
• Users can control themes, layout, and default modules
• Designed to make the app feel immersive and customizable

---