{"id":14384230,"url":"https://github.com/18F/ux-guide","last_synced_at":"2025-08-23T17:30:50.480Z","repository":{"id":37549687,"uuid":"138092801","full_name":"18F/ux-guide","owner":"18F","description":"Resources, norms, and practices for doing user experience research and design work at 18F.","archived":true,"fork":false,"pushed_at":"2023-12-14T21:13:53.000Z","size":3903,"stargazers_count":74,"open_issues_count":0,"forks_count":29,"subscribers_count":72,"default_branch":"main","last_synced_at":"2024-08-29T18:33:41.696Z","etag":null,"topics":["18f","ux","ux-research"],"latest_commit_sha":null,"homepage":"https://ux-guide.18f.gov","language":"HTML","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/18F.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2018-06-20T22:32:46.000Z","updated_at":"2024-08-06T23:38:42.000Z","dependencies_parsed_at":"2022-07-15T21:47:53.610Z","dependency_job_id":"5f1a6ea4-65ef-4397-b824-06e1c5b4f1a7","html_url":"https://github.com/18F/ux-guide","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fux-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fux-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fux-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/18F%2Fux-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/18F","download_url":"https://codeload.github.com/18F/ux-guide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230716450,"owners_count":18269759,"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":["18f","ux","ux-research"],"created_at":"2024-08-28T18:01:14.298Z","updated_at":"2024-12-21T12:30:23.117Z","avatar_url":"https://github.com/18F.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"**⚠️ This guide has moved to the [consolidated 18F guides repository](https://github.com/18F/guides).**\n\n# 18F UX Guide\n\n18F user experience (UX) designers join cross-functional teams to\ncollaboratively improve user experiences across government. This guide is here\nto help us get the job done. It’s neither a step-by-step tutorial nor a set of\nrules. Instead, it’s a starting point for 18F-led UX design: doing it,\ndiscussing it, and ensuring it’s done to a consistent level of quality. This\nguide is iterative and you can review\n[our goals](https://github.com/18F/ux-guide/wiki/Goals),\n[contribute](https://github.com/18F/ux-guide/blob/main/CONTRIBUTING.md) or get a\ngeneral overview below.\n\n---\n\n## Table of contents\n\n1. [About](https://github.com/18F/ux-guide/blob/main/_pages/about.md)\n1. Our approach\n    1. [Values and principles](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/values-and-principles.md)\n    1. [Defining design](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/defining-design.md)\n    1. [Stay lean](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/stay-lean.md)\n    1. [Meet partners where they are](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/meet-people-where-they-are.md)\n1. Research\n    1. [Clarify the basics](https://github.com/18F/ux-guide/blob/main/_pages/research/clarify-the-basics.md)\n    1. [Plan](https://github.com/18F/ux-guide/blob/main/_pages/research/plan.md)\n    1. [Do](https://github.com/18F/ux-guide/blob/main/_pages/research/do.md)\n    1. [Make research actionable](https://github.com/18F/ux-guide/blob/main/_pages/research/make-research-actionable.md)\n    1. [Legal](https://github.com/18F/ux-guide/blob/main/_pages/research/legal.md)\n    1. [Privacy](https://github.com/18F/ux-guide/blob/main/_pages/research/privacy.md)\n    1. [Bias](https://github.com/18F/ux-guide/blob/main/_pages/research/bias.md)\n    1. [Ethics](https://github.com/18F/ux-guide/blob/main/_pages/research/ethics.md)\n1. Design \n    1. [Build a prototype](https://github.com/18F/ux-guide/blob/main/_pages/design/build-a-prototype.md)\n    1. [Use a design system](https://github.com/18F/ux-guide/blob/main/_pages/design/use-a-design-system.md)\n1. Resources\n\n## Development\nThe UX Guide uses [USWDS-Jekyll](https://github.com/18F/uswds-jekyll).\n\n\n### Build\n\nTo build locally using Docker (recommended):\n\n1. Install [Docker for Mac](https://docs.docker.com/desktop/install/mac-install/)\n1. Clone this repository\n1. From this repository's root directory, run `docker-compose up --build`\n1. Open http://localhost:4000\n\nOr, build locally without Docker:\n\n1. Clone this repository\n1. Install [Jekyll](http://jekyllrb.com/) and the necessary dependencies by running `bundle install`\n1. Run the web server: `bundle exec jekyll serve`\n1. Open http://localhost:4000\n\n\n\n---\n\n## Contributors\n\nThis guide was collaboratively authored by members of 18F’s UX team past and present. While the initial content was pulled together over a few months, the guide builds on institutional knowledge from across 18F over the years. The following are the original members of the UX guide working group: \n\n- Qituwra Anderson\n- Melissa Braxton\n- Jeremy Canfield\n- Jennifer Damis\n- Matt Dobson\n- Vishal Iyer\n- John Donmoyer\n- Nikki Lee\n- Julia Lindpaintner\n- Corey Mahoney\n- Andrew Maier\n- Anne Petersen\n- Ben Peterson\n- Jacklynn Pham\n- Laura Poncé\n- Aditi Rao\n- Mark Trammell\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F18F%2Fux-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F18F%2Fux-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F18F%2Fux-guide/lists"}