Make a GTK4/libadwaita app accessible — accessible labels and roles, tooltips on icon-only buttons, keyboard navigation, contrast, and testing with Orca/Accerciser. Use when fixing a11y issues or running the accessibility category of a HIG audit.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Add search to a GNOME app — header-bar search button toggling a GtkSearchBar with SearchEntry, live filtering, Ctrl+F, and empty "no results" state. Use when adding search or filtering to lists or content views.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Flat page switching with AdwViewStack + AdwViewSwitcher (3-5 top-level views) and ViewSwitcherBar on narrow widths. Use when an app needs tabs/views in the header bar.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Onboarding tour with AdwCarousel and navigation dots, skippable welcome screens. Use when adding a first-run tour or feature showcase to a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Add a standard GNOME preferences dialog (AdwPreferencesDialog) with Ctrl+comma shortcut, PreferencesPage/Group rows, and GSettings bindings. Use when adding settings or preferences UI to a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Implement GNOME's 4-tier destructive-action pattern: undo toasts instead of confirmation dialogs, AdwAlertDialog for irreversible actions. Use when adding delete, remove, clear, or other destructive actions.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Loading, empty, and error states with AdwStatusPage and AdwSpinner — placeholder icons, titles, action buttons. Use when an app view can be empty, loading, or failed.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Add a Keyboard Shortcuts help window (Ctrl+question) listing all app accelerators, plus the standard GNOME accelerator set. Use when wiring keyboard shortcuts or the Keyboard Shortcuts menu item.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Add a standard AdwAboutDialog wired to app metadata, plus the AppStream metainfo file it should share data with. Use when adding an About entry, release notes, credits, or preparing app metadata.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Responsive GNOME layouts: AdwBreakpoint conditions, BreakpointBin, MultiLayoutView, BottomSheet, narrow/wide layout swaps. Use when making an app work on phones or narrow windows.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Package a GNOME app as a Flatpak — manifest for the GNOME runtime, sandbox permissions, build/run/test loop, and Flathub submission checklist. Use when packaging, distributing, or preparing a GNOME app for Flathub.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
GitHub Actions CI/CD for GNOME apps — build+test with GTK4/libadwaita on runners, Flatpak builds via flatpak-github-actions, attaching .flatpak bundles to releases, optional OCI publishing to GHCR, and headless GUI smoke tests with Xvfb/AT-SPI. Use when setting up CI, release automation, or GUI testing for a GTK app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Wire up GSettings: schema authoring, key naming, settings binding to widgets, window state persistence. Use when persisting app settings or window size/state in a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
AdwHeaderBar layout rules: button placement, flat/icon-only buttons, tooltips, title widgets, split buttons. Use when designing or fixing a GNOME app's header bar.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Audit a GTK4/libadwaita app for GNOME HIG compliance across 12 categories (text, icons, layout, shortcuts, accessibility, color, dialogs, responsiveness, CSS, GSettings, i18n), then fix violations category by category. Use when asked to audit, review, polish, or "make HIG-compliant" a GNOME app, or before a release/Flathub submission.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Build-system setup for GNOME apps per language: Python/PyGObject, Rust/gtk-rs, C, Vala, JavaScript/GJS — meson files, blueprint-compiler wiring, Flatpak manifests. Use when choosing a language for a GNOME app or setting up its build.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Scaffold a minimal GNOME-compliant GTK4/libadwaita app from scratch — window, header bar, ViewSwitcher, adaptive breakpoint, menu, preferences, GSettings schema, desktop entry, meson. Use when starting a new GNOME app or when the user asks for a GNOME app template.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Exclusive-choice UI: CheckButton radio groups in list rows, when to use them vs ComboRow vs ToggleGroup. Use when presenting mutually exclusive options in GNOME preferences or dialogs.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Sidebar layouts: AdwNavigationSplitView vs OverlaySplitView, sidebar widths, collapse breakpoints, navigation-sidebar styling. Use when adding a sidebar or master-detail layout to a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Multi-document tabs with AdwTabView/TabBar/TabOverview — tab menus, pinning, keyboard shortcuts. Use when an app opens multiple documents or sessions in tabs.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
In-app notifications: AdwToast/ToastOverlay with undo buttons, when to use toasts vs banners vs dialogs. Use when giving feedback after user actions in a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Sequential multi-step setup flow (assistant/wizard) with AdwNavigationView, Back/Forward navigation, progress indication. Use when building onboarding or setup flows with ordered steps.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트
Authoritative resource for building, auditing, and improving GNOME GTK4/libadwaita apps. Design tokens, 42-widget component library, 21 pattern skills, 47 mirrored HIG pages, 34 real-app audits, and lint scripts. Use when building a GNOME app, adding GNOME GUI features, auditing HIG compliance, packaging for Flatpak/Flathub, or when the user mentions GTK, libadwaita, Adw, Blueprint, or GNOME HIG.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
hanthor/gnome-gui-spec☆ 42026년 10월 11일 업데이트