Docs / Using FramePort

Themes

FramePort comes with three color themes, all dark:

Theme	Look
Portal (default)	The logo's two portals: orange for actions and the current selection, blue for secondary actions, progress and the PC side.
Portal (OLED)	Portal on true black, for OLED screens.
Original	FramePort's first look, with a violet accent.

Switch in Settings → Appearance. The change applies at once.

#Your own theme

A theme is a small JSON file. To make one:

In Settings → Appearance, pick the theme closest to what you want and click Copy this theme as a file.
Paste it into a text editor and save it as something.json.
Change the name and the colors you want different. You can delete every color you keep: missing colors come from the base theme.
Back in Settings → Appearance, click Install theme file… and choose the file. FramePort checks it, switches to it and keeps a copy in its data folder (themes/), so you can delete the original.

To remove an installed theme, click the bin icon on its card.

#Format

{
  "name": "Ember & Ice",
  "base": "portal",
  "dual": true,
  "colors": {
    "ACCENT": "#FF5A36",
    "SECONDARY": "#5CE1E6"
  }
}

Field	Meaning
`name`	Shown on the theme's card (up to 40 characters).
`base`	The built-in theme that fills in every color the file leaves out: `portal` (default), `portal_oled` or `original`.
`dual`	`true`: two-color touches like Portal's (blue-to-orange sidebar edge, two-color "FramePort", the selected tab's fade, blue secondary buttons). `false`: one accent, like Original. Default: the base's.
`colors`	Any of the colors below, as `#RRGGBB` or `#RGB`. Names may be upper or lower case.

Color	Used for
`BG`	Window background
`SIDEBAR`	Sidebar and activity panel
`SURFACE`, `SURFACE_2`, `SURFACE_3`	Cards; raised and hovered parts; inputs and chips
`BORDER`, `BORDER_STRONG`	Outlines
`TEXT`, `TEXT_2`, `TEXT_3`	Main text; secondary text; captions and disabled text
`ACCENT`, `ACCENT_SOFT`, `ON_ACCENT`	Main buttons and the current selection; its tint; text on it
`SECONDARY`, `SECONDARY_SOFT`	Secondary buttons, progress, switch tracks; its tint
`OK`, `WARN`, `ERROR`, `INFO`	Status: works, needs attention, failed, information
`PC`	PC VR games and "on this PC"

FramePort refuses a theme file it can't show well, and says why: a light window background (FramePort is dark only), text that's hard to read on cards, an unknown color name or a value that isn't a color. An example is in themes/example-theme.json.