fontsutil-font-usage

Use when modifying EasyPostman Swing UI fonts, especially when dialogs, labels, tables, tabs, or renderers look too large or too small, or when a change needs to stay consistent with the user's configured UI font size.

Ir a la instalación

Repositorio: lakernote/easy-postman
Última actividad en el origen: 16 de junio de 2026 a las 07:58
Idioma detectado de SKILL.md: inglés
Estrellas: 705
Forks: 60

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Volver a la búsqueda Volver a la instalación

name	fontsutil-font-usage
description	Use when modifying EasyPostman Swing UI fonts, especially when dialogs, labels, tables, tabs, or renderers look too large or too small, or when a change needs to stay consistent with the user's configured UI font size.

FontsUtil Font Usage

Use this skill when changing Swing font sizes in this repo. The goal is to keep UI text aligned with the user's configured base font size instead of freezing sizes with hard-coded deriveFont(..., 15f) style values.

When to use

A dialog or panel looks too large or too small after the user changes global font size
A patch is about title, subtitle, label, table, list, tab, or badge font sizing
You see hard-coded point sizes such as 13f, 15f, 18f, 22f
You are touching renderers or custom components that should track the repo's UI font setting

Core rules

If size changes, prefer FontsUtil.getDefaultFontWithOffset(style, offset).
If size should stay at the user default, use FontsUtil.getDefaultFont(style).
Avoid absolute point sizes for normal app UI unless there is a strong visual reason.
Keep offsets modest for standard dialogs. Typical ranges in this repo:
- body text: 0 or -1
- secondary/meta text: -1 or -2
- section/list titles: +1
- dialog/detail titles: +1 or +2
If only weight changes and size should remain exactly as-is, font.deriveFont(Font.BOLD) is acceptable.
Do not solve localized English/Chinese text overflow by shrinking fonts first. Fix layout constraints, short i18n keys, wrapping, dynamic measurement, or tooltip-backed truncation before changing typography.

Repo-specific guidance

For module placement, FontsUtil and reusable typography helpers belong in easy-postman-ui; startup-time application of font settings is app/platform orchestration. See docs/ARCHITECTURE_MODULES_zh.md.
FontsUtil lives at: easy-postman-ui/src/main/java/com/laker/postman/util/FontsUtil.java
FontsUtil reads the configured ui_font_size, clamps it, and derives from UI defaults.
For this repo, using FontsUtil is the correct way to respect user-configured font size and keep fallback chains intact.

Anti-patterns

label.getFont().deriveFont(Font.BOLD, 18f) for regular dialog headers
Mixing FontsUtil and hard-coded point sizes in the same panel without a reason
Fixing a "font too big" complaint by picking another absolute size
Reducing the UI font offset because an English button, tab, or label does not fit a Chinese-sized container

Verification

Check the changed view with the user's current UI font size.
Confirm titles, meta text, and body text still have a clear visual hierarchy.
If the change is in app code, rebuild with mvn -q -pl easy-postman-app -am -DskipTests compile.