Skip to main content
Version: v1

Customizing DevPortal

VeeCode DevPortal follows Backstage's standards for customizing the UI and adds a few extra options:

  • Simple branding: there is an entire branding section under app.branding in the app configuration that lets you pick one of the pre-defined theme variants and its light/dark options, allowing you to customize every aspect of the theme. In a Helm install this lives under upstream.backstage.appConfig; in a Docker/distro install it lives at the top level of app-config.local.yaml.

  • Custom theme hacking (legacy): the global.theme.customJson Helm value allows low-level JSON overrides of the internal theme file. This is a Helm-only workaround — see Theme hacking for details. For most use cases, the app.branding.theme.* mechanism above is sufficient and preferred.

  • Custom home page plugin: the entire home page can be customized by replacing the default homepage dynamic plugin with your own. See Custom home plugin.

  • Custom header plugin: the header shared by all pages can also be customized as a dynamic plugin. See Custom header plugin.

Usually the branding option is all you need to customize the look and feel of your DevPortal. If you need to go beyond that, you can use the custom theme hacking option or even create a custom plugin if you are feeling brave.