Skip to Content
AdministrationAppearance

🎨 Appearance

Customize the look and feel of Sniffer - themes, brand colors, gradients, dark mode β€” at the company level and per project.


🌟 Overview#

Appearance lets your team make Sniffer feel like your product. Set a brand color, build gradients, switch between flat and gradient themes, pick light/dark mode, and apply your theme across the entire workspace.

Themes exist at two levels:

  • 🏒 Company-level β€” applied across every project for everyone in the org (default fall-back)
  • πŸ“ Project-level β€” overrides the company theme for a specific project


🏒 Company Appearance#

Route: Company Settings β†’ Appearance

Lists every theme defined at the company level β€” built-in themes (Purple, Brown, Dark, Orange) and any custom ones you’ve created.

Theme Card#

Each theme is shown as a card with:

  • Preview swatch (primary + secondary gradient)
  • Theme name
  • Built-in lock icon for system themes (cannot delete)
  • Edit Β· Delete Β· Apply actions

Adding a New Theme#

Click + New Theme to open the editor.


πŸ“ Project Appearance#

Route: Project Settings β†’ Appearance (/sf/projects/:id/settings/appearance)

Pick from the company themes or create a project-specific one. The project theme overrides the company default for users viewing that project.


🎨 Theme Editor#

Form Fields#

FieldTypeDescription
Theme TitleText inputRequired β€” must be unique within the company
Enable Flat ThemeToggleOFF = use a gradient (primary + secondary). ON = use only the primary color
Primary ColorColor pickerThe main brand color
Secondary ColorColor pickerUsed only when Flat Theme is OFF; creates a gradient with the primary
Light / Dark ModeToggleDefault visual mode for users on this theme

Color Picker#

Each color picker provides:

  • HEX input β€” type a hex value (with or without #)
  • RGB sliders β€” fine-tune R/G/B
  • Alpha slider β€” opacity 0–1
  • Preset palette β€” quick brand swatches
  • Live preview square showing the current color

Live Preview#

A panel on the right of the editor renders the active theme on a mock-up of the Sniffer UI β€” sidebar, button states, badges, charts β€” so you see the impact before saving.


πŸ’Ύ Theme Operations#

ActionDescription
CreateSave a new custom theme
UpdateModify an existing theme’s name or colors
DeletePermanent β€” built-in themes cannot be deleted
Save and ApplySave the theme and apply it immediately to the current scope (company or project)
Apply onlyApply an existing theme without editing
DuplicateClone a theme as a starting point

Validation: theme names must be unique within scope; an attempt to create a duplicate name is blocked with an inline error.


πŸŒ— Light vs. Dark Mode#

Each user can also pick their personal light/dark preference, which overrides the theme default for their view. The choice is stored in localStorage so it persists between sessions.


🏷️ Logos & Branding#

Beyond colors, you can upload:

  • Company logo (square + horizontal variants) β€” appears in the header and emails
  • Project logo β€” appears on the project card and in the widget header
  • Favicon β€” browser tab icon for self-hosted instances

Set these from 🏒 Company Settings β†’ Company InformationΒ  (company-level) or Project Settings β†’ General (project-level).


🎯 Where Themes Apply#

SurfaceTheme Source
Sniffer web appProject, falls back to company
Feedback widget (embedded)Project (set during widget config)
🧩 Sniffer for Jira Company
Email notificationsCompany
πŸ”Œ Browser ExtensionΒ Company

πŸ” Permissions#

ActionRequired Permission
View themesAPPEARANCE.VIEW
Create / edit themeAPPEARANCE.EDIT
Delete themeAPPEARANCE.EDIT
Apply themeAPPEARANCE.EDIT

TopicDescription
🏒 Company Settings β†’Where company-level themes live
βš™οΈ Settings & Permissions β†’Project-level appearance overrides
πŸ’¬ Feedback β†’The widget inherits the project theme
πŸ“ Projects β†’Project icon colors and branding

Β© 2026 Your Company