{"id":18485474,"url":"https://github.com/system76/shig","last_synced_at":"2025-10-31T13:30:40.453Z","repository":{"id":72817629,"uuid":"99152274","full_name":"system76/shig","owner":"system76","description":"Style \u0026 Human Interface Guidelines","archived":false,"fork":false,"pushed_at":"2017-12-01T20:03:36.000Z","size":14,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-12-25T14:25:01.779Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://system76.github.io/shig/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/system76.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-02T19:13:36.000Z","updated_at":"2024-10-29T15:06:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"0ca19c2d-410a-4ef4-b001-705d528fad00","html_url":"https://github.com/system76/shig","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/system76%2Fshig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/system76%2Fshig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/system76%2Fshig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/system76%2Fshig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/system76","download_url":"https://codeload.github.com/system76/shig/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239201639,"owners_count":19599078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T12:45:22.315Z","updated_at":"2025-10-31T13:30:40.421Z","avatar_url":"https://github.com/system76.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# System76 Style \u0026 Human Interface Guidelines\n\nThe Style \u0026 Human Interface Guidelines (SHIG) are designed to help our\ndevelopers and designers maintain a consistent and pleasant experience for end\nusers across our web and desktop products.\n\n\n# UI\n\n## Dialogs \u0026 Actions\n\nWhen presenting a dialog or action, include Primary and Secondary text as well\nas Actions.\n\n\n### Primary Text\n\nBasic information and a suggestion.\n\n\n### Secondary Text\n\nFurther details, including any non-obvious consequences of actions.\n\n\n### Actions\n\nAligned right-to-left at the bottom of the UI. Affirmative/suggested action,\ncancel (if applicable), and any secondary actions.\n\n\n# Copy\n\n## Common Terms to Use \u0026 Avoid\n\n### Products\n\nIf you are unable to know the explicit type, use the generic term\n\"product\" when referring to a customer's product. Avoid semi-generic terms like\n\"computer\". If you can determine whether it's a laptop, desktop, accessory,\netc., use that more specific term. If you know the specific product, use its\nproduct name when it makes sense.\n\n\n### Payment Methods\n\nUse the term `payment methods`, not `transaction methods`, `payment cards`, or\nanything else when being generic. If you know the type of a specific payment\nmethod in context (i.e. a card or financing), feel free to be more specific.\nHowever, avoid `credit card` or `debit card`, since we can't distinguish between\nthe two; instead, just say, `card`.\n\n\n## Measurements \u0026 Units\n\nUse a space between numbers and text units, eg. `72 TB` and `4.0 GHz` instead of\n`72TB` and `4.0GHz`. For feet and inches, use the prime (′, `\u0026prime;`) and\ndouble-prime (″, `\u0026Prime;`) entities. For pounds and kilograms, always\nabbreviate, but do not use a period after the abbreviation, eg. use `2.5 lbs`,\nnot `2.5 lbs.`.\n\n\n### Display \u0026 Camera Resolutions\n\nWhen describing resolutions, always use a times symbol (×, `\u0026times;`) between\nthe pixel width and height with no spaces, eg. `3200×1800`. Default to using the\nactual resolution (`1920×1080`, `3200×1800`, `3840×2160`, etc.) and not more\nambiguous terms.\n\nTo describe a high-density pixel-doubled screen, always use the term `HiDPI`;\nthe fact that they are HiDPI is what matters, not the exact physical resolution.\nRelegate exact pixel resolutions to tech specs or supplementary text.\n\nWhen a shorthand for the resolution exists, use it when space is limited, but\n**only** when it exactly matches what is in the table below. **Never** use it as\na replacement for the actual resolution in tech specs, as customers are looking\nfor the specific pixel resolutions there.\n\nResolution | Shorthand\n---------- | ---------\n1280×720   | `720p`\n1920×1080  | `1080p`\n2560×1440  | `1440p`\n3200×1800  | None; use `3200×1800`\n3840×2160  | `4K`\n5120×2880  | `5K`\n\n\n### Money \u0026 Prices\n\nUse whole dollar amounts for customer-facing pricing and copy. Only use cents\nonce taxes and/or shipping get involved (where we can't round them to the\ndollar).\n\n\n## Third-Party Brand Names\n\nNVIDIA should always be written as `NVIDIA` in both component names and general\ncopy. Intel should include the registered symbol (®, `\u0026reg;`) i.e. `Intel®` in\ntech specs and catalog product option descriptions, but **not** in component\nnames or general copy.\n\n---\n\nThe System76 HIG is heavily influenced by [elementary](https://elementary.io).\nFor anything not covered in this document, refer to the [elementary\nHIG](https://elementary.io/docs/human-interface-guidelines).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystem76%2Fshig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystem76%2Fshig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystem76%2Fshig/lists"}