Repository files navigation

Fully Decoupled CMS•Progressive Web App •Knowledge Graph & CI Workflows

UX Methods is a content-first Jamstack website built withSanity and11ty, and coordinated with a lightweight knowledge graph running onData.world. Its goal is to document and interconnect the practices and techniques of user experience design, and to provide a use case from which to explore the possibilities of"boutique" knowledge graphs.

This repository is a monorepo of three interrelated but distinct pieces: content management, web application, and continuous integration, which includes knowledge graph production and integration.

UX Methods is built and maintained as a content-first resource. This means that content is structured to communicate meaning based on user and organization needs, not around the web requirements of particular "pages." UX Methods uses the fully decoupled headless CMS Sanity to structure, produce, and distribute content. This functionality is located in thestudio folder of this repository.

UX Methods uses the 11ty static site generator to publish content as a progressive web app (PWA). 11ty is also used to publish content as Linked Data (JSON-LD) in parallel with HTML pages in order to support content findability, interoperability, and reuse. PWA code is located in theweb folder.

GitHub Actions workflows are used tobuild and publish updates to the UX Methods PWA when content is added or updated. A customRDF-Transform GitHub Action and workflow are also used to transform content data from the Sanity headless CMS content API into RDF triples, then upload those triples to theUX Methods dataset on Data.world. This dataset is queried during the PWA build workflow and used to coordinate the related content recommendations and prioritization.