<!--
SPDX-FileCopyrightText: 2026 Claire Tam <claire.tam@student.adelaide.edu.au>
SPDX-FileCopyrightText: 2026 fractuscontext <106440141+fractuscontext@users.noreply.github.com>

SPDX-License-Identifier: LPPL-1.3c
-->

# user-persona: LaTeX Package for UX & HCI

![Screenshot](./user-persona-example-screenshot.png)

LaTeX Package for creating user personas.

## Who Is This For?

A **user persona** is a fictitious but research-grounded representation of a target user group, synthesising observed behaviours, goals, and frustrations into a named, humanised archetype [(Cooper, 1999)](https://doi.org/10.1007/978-3-322-99786-9_1)

They serve as a shared vocabulary between designers, developers, and stakeholders, anchoring design decisions in empirical user research rather than internal assumptions. [(Nielsen 2019)](https://doi.org/10.1007/978-1-4471-7427-1).

- Software Engineering students
- UX researchers
- Human-Computer Interaction (HCI) practitioners
- and product designers who maintain documentation within a LaTeX workflow.

## Quick Start

See the example persona by downloading from [Github Releases](https://github.com/fractuscontext/user-persona/releases/) or [visiting CTAN](https://ctan.org/pkg/user-persona).

```latex
% \documentclass{article}
\usepackage{user-persona}

% \begin{document}
\begin{persona}{Zhang Wei}
  \personaphoto{photo.jpg}
  \personaquote{``If the robot crashes, I reboot it and send a WeChat voice note.''}
  \personafact{Age}{30}
  \personafact{Location}{Mainland China}

  \personasection{Goals}{PersonaGreen}{
    \item Complete the shift with zero system failures.
    \item Find content to combat boredom during monitoring.
  }

  \personasection[right]{Pain Points}{PersonaRed}{
    \item Physical strain from 10 hours of screen glare.
    \item Frustration with text-heavy Western software interfaces.
  }
\end{persona}
% \end{document}
```

Please see the full documentation at `./user-persona.tex`.

## Development & Contributing & License

This repository is licened under LPPL-1.3c; and proudly uses [Nix](https://nixos.org/) for a fully reproducible
environment.

- **Enter shell:** `nix develop` (provides `just`, `lualatex`, `latexmk`, `chktex`, `ctanify`, `reuse`)
- **List tasks:** `just`
- **Build PDFs only:** `just docs`
- **Build CTAN bundle:** `just ctan [version]`
- **Lint SPDX headers:** `reuse lint`