Product Name in Desktop Title Bar

desktop-apps specs/desktop-apps/title-bar.kmd

Como exibir o nome do produto na barra de título de apps desktop Koder (Linux/macOS/Windows). Define formato canônico, casos de tela, sufixos (Untitled, dirty marker), e proibições.

Quando esta spec se aplica

Todos os triggers

Corpo da especificação

Spec — Product Name in Desktop Title Bar

Applicability

Any Koder product (koder-*) that ships a desktop GUI — Flutter desktop, GTK, Qt, Electron, etc. Does not apply to mobile-only, web-only, or CLI products.

Required Behavior

The product's name must appear in the window title bar of the main window.

Implementation

  • Set the window title via window_manager (windowManager.setTitle(appName)) or the native framework equivalent.
  • In Flutter, also set MaterialApp(title: appName).
  • Use the constant appName defined in lib/core/constants.dart of the product, e.g.:
    const String appName = 'Koder Video';
    

Deterministic Audit Checks

A checker can verify:

  1. lib/core/constants.dart (or equivalent) exports an appName string constant.
  2. The main window creation code passes appName to the title bar setter.
  3. MaterialApp(title: ...) uses appName (Flutter only).

Referências