Getting Started
Themes
Choose a theme to set the structure of your Dev Portal: the page width, the header menu position, and the page style. A theme applies to every page at once.
Overview
A theme customizes the layout of your Dev Portal: how wide the pages are, where the main menu sits in the header, and whether the content sits in an open page, a rounded frame, or separate cards. You pick one theme for the whole portal, and it applies to every page at once, including the built-in pages such as API documents and the applications list. Your pages, navigation, and content stay as they are.
Konnect Dev Portal ships multiple themes, and more are coming. Colors are set separately through theme.colors, and every theme accepts them, so you can change the layout without touching your palette. See Primary color.
Available themes
Each theme has a live preview portal where you can browse a full Dev Portal built with that theme.
Mesa
A focused, modern theme that centers content at a comfortable reading width.
Grove
A soft, structured look where the header and sidebar rest on a tinted backdrop and your content sits in a rounded frame.
Pebble
A smooth, layered look where your navigation, content, and table of contents sit as separate rounded cards on a soft backdrop, with a floating rounded header above.
Ocean
A spacious theme where content spans the full width of the page, with a centered header menu and clean borders between sections.
Setting the active theme
Set the theme.name property in the Portal's Appearance customization settings, or via the /v3/portals/{portalId}/customization endpoint.
One of: 'mesa' | 'grove' | 'pebble' | 'ocean'
{
"theme": {
"name": "mesa"
}
}
When theme.name is missing, or names a theme the portal cannot render, the portal renders ocean, so a portal that has never set theme.name keeps the default look.