https://github.com/andybywire/ux-methods
A lightweight Jamstack knowledge graph application
https://github.com/andybywire/ux-methods
11ty githubaction-workflow jamstack knowledge-graph sanity ux-design ux-methods
Last synced: 1 day ago
JSON representation
A lightweight Jamstack knowledge graph application
- Host: GitHub
- URL: https://github.com/andybywire/ux-methods
- Owner: andybywire
- License: mit
- Created: 2021-10-05T02:08:48.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-12-22T01:04:28.000Z (4 days ago)
- Last Synced: 2025-12-23T12:46:54.008Z (2 days ago)
- Topics: 11ty, githubaction-workflow, jamstack, knowledge-graph, sanity, ux-design, ux-methods
- Language: TypeScript
- Homepage: https://uxmethods.org
- Size: 23.9 MB
- Stars: 13
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
The User Experience Practices Knowledge Graph
Fully Decoupled CMS
•
Progressive Web App
•
Knowledge Graph & CI Workflows
## Overview
[UX Methods](https://www.uxmethods.org/) is a content-first Jamstack website built with [Sanity](https://www.sanity.io/) and [11ty](https://www.11ty.dev/), and coordinated with a lightweight knowledge graph running on [Data.world](https://data.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](https://www.linkedin.com/pulse/uxmethodsorg-boutique-knowledge-graph-case-study-andy-fitzgerald/?trackingId=FsKbRBiJS9SiKWq3uiBDug%3D%3D).
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.
## Content Management
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 the [**studio**](https://github.com/andybywire/ux-methods/tree/main/studio) folder of this repository.
## Progressive Web App
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 the [**web**](https://github.com/andybywire/ux-methods/tree/main/web) folder.
## Knowledge Graph Integration and Continuous Integration Workflows
GitHub Actions workflows are used to [build and publish updates](https://github.com/andybywire/ux-methods/tree/main/.github/workflows) to the UX Methods PWA when content is added or updated. A custom [RDF-Transform GitHub Action](https://github.com/andybywire/ux-methods/tree/main/actions/rdf-transform) and workflow are also used to transform content data from the Sanity headless CMS content API into RDF triples, then upload those triples to the [UX Methods dataset on Data.world](https://data.world/andyfitzgerald/ux-methods). This dataset is queried during the PWA build workflow and used to coordinate the related content recommendations and prioritization.