Site Settings: Theme Colours
Configure colour settings across categories: UI elements, validation states, content type badges, HTTP methods, status codes, and knowledge map visualisations.
The Theme tab provides colour settings organised into collapsible sections. These colours control the appearance of the published viewer across all components including pages, API documentation, schemas, diagrams, and the knowledge map.
1. UI Elements
Core interface colours that affect the overall look and feel.
| Property | Description |
|---|---|
| UI border colour | General border colour for panels and components |
| UI text primary colour | Primary text colour |
| UI text secondary colour | Secondary text colour |
| UI text tertiary colour | Tertiary text colour |
| UI text muted colour | Muted/disabled text colour |
| UI hover background colour | Background colour on hover states |
| Content link colour | Hyperlink colour in content areas |
| CTA section background colour | Background for call-to-action sections |
| CTA section text colour | Text colour in call-to-action sections |
| Loader colour | Loading spinner colour |
2. Validation States
Colours for success, error, warning, and info indicators.
| State | Properties |
|---|---|
| Success | Background colour, border colour, text colour |
| Error | Background colour, border colour, text colour |
| Warning | Background colour, text colour |
| Info | Background colour, text colour |
3. Content Type Badges and Active States
Colours for content type badges (Page, Endpoint, Schema, API Definition) in both normal and active/selected states.
Normal State
| Content Type | Properties |
|---|---|
| Page | Background colour, text colour |
| Endpoint | Background colour, text colour |
| Schema | Background colour, text colour |
| API Definition | Background colour, text colour |
Active/Selected State
Each content type also has active state colours for when the item is selected or highlighted.
| Content Type | Properties |
|---|---|
| Page | Active background, active text, active border colour |
| Endpoint | Active background, active text, active border colour |
| Schema | Active background, active text, active border colour |
| API Definition | Active background, active text, active border colour |
4. HTTP Methods
Colours for HTTP method badges in REST API documentation.
| Method | Properties |
|---|---|
| GET | Background colour, text colour |
| POST | Background colour, text colour |
| PUT | Background colour, text colour |
| PATCH | Background colour, text colour |
| DELETE | Background colour, text colour |
| HEAD | Background colour, text colour |
| OPTIONS | Background colour, text colour |
5. HTTP Status Codes
Colours for HTTP status code badges in API response documentation.
| Range | Meaning | Properties |
|---|---|---|
| 2xx | Success | Background colour, text colour |
| 3xx | Redirect | Background colour, text colour |
| 4xx | Client error | Background colour, text colour |
| 5xx | Server error | Background colour, text colour |
| Default | Unknown codes | Background colour, text colour |
6. Knowledge Map
Colours for nodes and edges in the knowledge graph visualisation. Separate colours exist for light mode and dark mode.
Node Colours (Light and Dark Mode)
Each node type has fill, stroke, and text colours for both light and dark modes.
| Node Type | Properties (per mode) |
|---|---|
| Page | Fill colour, stroke colour, text colour |
| REST API | Fill colour, stroke colour, text colour |
| Schema | Fill colour, stroke colour, text colour |
| Diagram | Fill colour, stroke colour, text colour |
| API Definition | Fill colour, stroke colour, text colour |
Edge Colours (Light and Dark Mode)
Relationship lines between nodes in the knowledge graph.
| Edge Type | Properties |
|---|---|
| Link | Colour (light mode), colour (dark mode) |
| Reference | Colour (light mode), colour (dark mode) |
| Inheritance | Colour (light mode), colour (dark mode) |
Additional Theme Properties
| Property | Description |
|---|---|
| Deprecated background colour | Background for deprecated element badges |
| Deprecated text colour | Text colour for deprecated elements |
| Enum value background colour | Background for enum value badges |
| Enum value text colour | Text for enum value badges |
| Schema ref background colour | Background for schema reference badges |
| Schema ref text colour | Text for schema reference badges |
| Highlight background colour | Background for highlighted/selected content |
| Focus highlight colour | Focus ring colour for keyboard navigation |
| Focus highlight colour (light) | Lighter variant for focus backgrounds |