---
title: "About this guide"
source: 18F Guides
source_url: https://github.com/18F/guides
licence: CC0-1.0
domain: engineering
subdomain: 18f-guides
date_added: 2026-04-25
---

18F user experience (UX) designers join cross-functional teams to improve interactions between government agencies and the people they serve. The 18F UX Guide helps us get this job done. It’s a starting point for UX design at 18F: doing it, discussing it, and ensuring it’s done to a consistent level of quality.

## What this guide is

Like [our content guide]({{ '/content-guide/' | url }}), the 18F UX guide is written for our internal designers, but we hope it’s a useful reference for anyone. Our working assumptions for this guide include that 18F UX designers are expected to possess, among other things:

* design research skills
* the ability to skillfully navigate organizational relationships
* the ability to deliver artifacts that guide development, like wireframes and prototypes

This guide includes information that may be new to the designers we hire (who may be new to government), and useful starting points for conversations with the people we work with (who may be new to UX design). For details of specific UX activities and how to conduct them, see [18F's methods](https://guides.18f.gov/methods/).

18F staff should consult additional guidance:

* [TTS Handbook page on doing research at Technology Transformation Services](https://handbook.tts.gsa.gov/research-guidelines/)
* [New Hire README](https://docs.google.com/document/d/19naJ8wgVo_hnv_nUy2WWyzH6DJwXXgenD0QpsZmOSe0/edit#)
* [Project Start Guide](https://docs.google.com/document/d/1jFGksReKrt2PY_QVe7fj1aOCcyjHlGPf5hkKgv7nuMA/edit?pli=1#)
* [Before You Ship guide](https://before-you-ship.18f.gov/)


## How to use this guide

We created this guide for our reference. It’s here for a refresher on [ways to protect research participant privacy]({{ 'research/privacy/' | url }}), or for quick access to [design-related templates, presentations, etc.]({{ '/ux-guide/resources/' | url }}) You’re also welcome to read it from start to finish if you like.

This guide is divided into three sections:
- **Our Approach** describes essential components that shape our design practice: our [team values and principles]({{ 'our-approach/values-and-principles/' | url }}), our [definitions of design]({{ 'our-approach/defining-design/' | url }}), and our commitment to [staying lean]({{ 'our-approach/stay-lean/' | url }}). It also describes how we [meet partners where they are]({{ 'our-approach/meet-partners-where-they-are/' | url }}).
- **Research** describes the process by which we systematically frame problems, explore options, and evaluate solutions. It includes articles on research [basics]({{ 'research/clarify-the-basics/' | url }}) (working definitions) and how we [plan]({{ 'research/plan/' | url }}), [do]({{ 'research/do/' | url }}), and [analyze, synthesize, and share]({{ 'research/make-research-actionable/' | url }}) research.
- **Design** describes how we communicate and clarify what we’re building throughout the design process. It includes articles on how we [build prototypes]({{ 'design/build-a-prototype/' | url }} ) and [use design systems]({{ 'design/use-a-design-system/' | url }}).

If you have any suggestions or want to get involved, read [our contributing page](https://github.com/18F/guides/blob/main/CONTRIBUTING.md); find us on Slack in either #ux, #ux-guide, or #g-research; or [create an issue in GitHub](https://github.com/18F/guides/issues).


## Reusing this guide in other organizations

As a work of the federal government, this project is in the public domain within the United States. Additionally, we waive copyright and related rights in the work worldwide through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/legalcode).

This guide is written for internal use and is shared in the spirit of open source.  This guide is a product of what we’ve learned from doing UX research and design in government over the past few years, in collaboration with GSA’s Office of General Counsel, Privacy Office, PRA (Paperwork Reduction Act) Desk Officer, and our agency partners.

Feel free to [fork this guide](https://help.github.com/articles/fork-a-repo/) on GitHub and personalize it for your organization; we trust you’ll change it in whatever ways best suit you. Also, if you have a suggestion, spot an error, or otherwise want to make constructive contribution to this guide, head over to [our contributing page](https://github.com/18F/guides/blob/main/CONTRIBUTING.md).

## References

This guide draws on information from many resources. GSA cannot endorse these resources, or their respective authors. GSA employees interested in further reading can access a list of [references](https://docs.google.com/document/d/1ZH6TrVBOQvmlUFRKZlFFk182fiOhyaqyZqiTrVcEW4w/edit?folder=18EUSppsHd4O2eKwMiYXtxNd29O2TH31S#heading=h.v2me8g6plb8y).
