{"id":485,"date":"2026-11-22T14:55:34","date_gmt":"2026-11-22T13:55:34","guid":{"rendered":"https:\/\/linuxundich.de\/en\/?p=485"},"modified":"2026-11-22T14:55:34","modified_gmt":"2026-11-22T13:55:34","slug":"kirigami-design-guide-kde-design-rules","status":"publish","type":"post","link":"https:\/\/linuxundich.de\/en\/kirigami-design-guide-kde-design-rules\/","title":{"rendered":"Kirigami Design Guide: All of KDE&#8217;s design rules on one site"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">If you want to build good-looking, modern, easy-to-use apps that fit neatly into the KDE desktop, you have to dig through quite a bit of documentation. The Human Interface Guidelines over here, the icon guidelines over there, then the Kirigami tutorial, and the API reference on top of that. Tedious and time-consuming. The <a href=\"https:\/\/n4n0gh.github.io\/Doku\/\">Kirigami Design Guide<\/a> brings all of it together in one place.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The site is split into foundations such as colors, spacing, typography, and icons, into patterns for navigation, lists, feedback, or accessibility, and into ready-made components such as cards, dialogs, and forms. Each topic is explained in plain words, with a picture of what the result looks like and the matching QML code to copy right next to it.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6b02fb94b59aa&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6b02fb94b59aa\" class=\"wp-block-image wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" height=\"720\" sizes=\"auto, (max-width: 781px) 100vw, 680px\" srcset=\"https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-01-karten-640x360.webp 640w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-01-karten-768x432.webp 768w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-01-karten-1280x720.webp 1280w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-01-karten.webp 1320w\" width=\"1280\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-01-karten-1280x720.webp\" alt=\"Kirigami Design Guide in Firefox: the Cards page with a sample card and numbered explanations\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">The page on cards shows a sample card from Kirigami and explains its four parts, from the banner and title to the content and the actions.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">If you would rather learn from an example, work through the tutorial. In seven steps, you build a small to-do app. Each step comes with the code and also with the reasoning behind it, for instance why a button is grayed out instead of hidden. The pictures show Kirigami 6.31 with the Breeze style, so you see what the apps will look like on <a href=\"https:\/\/linuxundich.de\/en\/30-years-kde-plasma-6-8-documentary\/\">KDE Plasma<\/a>.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6b02fb94b5ce3&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6b02fb94b5ce3\" class=\"wp-block-image wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" height=\"720\" sizes=\"auto, (max-width: 781px) 100vw, 680px\" srcset=\"https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-02-tutorial-640x360.webp 640w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-02-tutorial-768x432.webp 768w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-02-tutorial-1280x720.webp 1280w, https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-02-tutorial.webp 1320w\" width=\"1280\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/linuxundich.de\/wp-content\/uploads\/2026\/11\/kirigami-design-guide-02-tutorial-1280x720.webp\" alt=\"Kirigami Design Guide in Firefox: tutorial step 3 with the QML code for the to-do app's entry field\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><figcaption class=\"wp-element-caption\">In the tutorial, the to-do app gets an entry field. Thanks to the Copy button, the QML code goes straight into your own project.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">By the way, none of this is official: the guide is a community project that does not come from KDE e.V. The texts are based on KDE&#8217;s Human Interface Guidelines and, like them, are licensed under CC BY-SA 4.0. Anyone working on KDE apps should be happy about it all the same. Vibe coders, too: instead of feeding an LLM half a dozen documents, just hand it this one guide to learn from.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Kirigami Design Guide brings the Human Interface Guidelines, icon rules, and Kirigami components together in one place. Handy for anyone working on KDE apps, and for vibe coders, too.<\/p>\n","protected":false},"author":2,"featured_media":486,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"lui_source_id":48854,"lui_source_hash":"7d668c8422d3670b90540809a72f57926189a1762268c93bff674fb6a5a42318","lui_source_translated":"2026-11-22","lui_source_reviewed":true,"lui_via_url":"","lui_via_label":"","lui_source_url":"","lui_source_label":"","lui_inhalt_aktualisiert":"","lui_pin_until":"","lui_kopf":"","lui_frage":"","footnotes":""},"categories":[5],"tags":[36,37,51,66],"class_list":["post-485","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-news","tag-ai","tag-kde","tag-open-source","tag-tips"],"_links":{"self":[{"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/posts\/485","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/comments?post=485"}],"version-history":[{"count":1,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/posts\/485\/revisions"}],"predecessor-version":[{"id":487,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/posts\/485\/revisions\/487"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/media\/486"}],"wp:attachment":[{"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/media?parent=485"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/categories?post=485"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linuxundich.de\/en\/wp-json\/wp\/v2\/tags?post=485"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}