Thoughtworks Technology Radar Volumes

Note

This repository is a personal project and is not officially affiliated with Thoughtworks

A CLI and complete collection of datasets for the popular Thoughtworks Technology Radar, including all archived volumes

Datasets

How to use

There are a few ways you can use to view the interactive technology radar

1. My own hosted radar with enhancements - radar.setchy.io
2. via my catalogue - setchy.io/radars
3. Thoughtworks hosted radar - radar.thoughtworks.com
4. self-hosted BYOR radar - thoughtworks/build-your-own-radar

Available data formats

The technology radar datasets are provided in three formats; CSV, JSON and a combined Google Sheets document.

Important

When using either the CSV or JSON data formats, please make sure to use the the GitHub RAW file URL (eg: Volume 33)

• GitHub - Thoughtworks Volumes (CSV)
• GitHub - Thoughtworks Volumes (JSON)
• Google Sheets - Thoughtworks Technology Radar Volumes

How are the datasets updated?

The CSV, JSON and Google Sheets datasets are automatically checked for any updates weekly.

Note

Thoughtworks typically publish a new technology radar volume twice per year.

Command Line Interface (CLI)

Getting Started

pnpm i && pnpm start help

Usage

Usage: tech-radar-volumes [options] [command]

A CLI tool to fetch and process ThoughtWorks Tech Radar data

Options:
  -V, --version     output the version number
  -h, --help        display help for command

Commands:
  fetch             group commands for fetching/ingesting data
  volumes [type]    generate publication volumes in specified format(s).
                    Inputs: requires `data/master.json`.
                    Output: generated volumes will be saved in `volumes/*`.
  search [options]  search master dataset for a keyword (defaults to name and
                    description)
  filter [options]  filter master dataset by volume, quadrant, ring or status
  stats [options]   show statistics for the master dataset
  help [command]    display help for command

Examples:
  $ tech-radar-volumes
  $ tech-radar-volumes fetch links
  $ tech-radar-volumes fetch data
  $ tech-radar-volumes volumes csv
  $ tech-radar-volumes stats --by=quadrant -o json
  $ tech-radar-volumes search -k react
  $ tech-radar-volumes search -k "test cafe" -o json
  $ tech-radar-volumes filter -v 10 -q "languages-and-frameworks" -o csv
  $ tech-radar-volumes stats --by=volume -o table
  $ tech-radar-volumes help volumes
  $ tech-radar-volumes help

Subcommands

Note

Commands that operate on existing data (search, filter, stats, volumes) require a populated data/master.json file. Generate it with tech-radar-volumes fetch data.

volumes

Usage: tech-radar-volumes volumes [options] [type]

generate publication volumes in specified format(s).
Inputs: requires `data/master.json`.
Output: generated volumes will be saved in `volumes/*`.

Arguments:
  type        type of report to generate (choices: "all", "csv", "json",
              "google-sheets", default: "all")

Options:
  -h, --help  display help for command

fetch

Usage: tech-radar-volumes fetch [options] [command]

group commands for fetching/ingesting data

Options:
  -h, --help      display help for command

Commands:
  links           fetch blip page links from sitemap
  data            fetch detailed blip history and write data/master.json
  all             run links, data and generate volumes
  help [command]  display help for command

search

Usage: tech-radar-volumes search [options]

search master dataset for a keyword (defaults to name and description)

Options:
  -k, --keyword <keyword>  keyword to search for
  -f, --field <field>      specific field to search (name, quadrant, ring,
                           description)
  -v, --volume <volume>    filter by volume number or name
  -o, --output <format>    output format: text|json|jsonl|csv|table (default:
                           "text")
  -h, --help               display help for command

filter

Usage: tech-radar-volumes filter [options]

filter master dataset by volume, quadrant, ring or status

Options:
  -v, --volume <volume>      filter by volume number or name
  -q, --quadrant <quadrant>  filter by quadrant
  -r, --ring <ring>          filter by ring
  -s, --status <status>      filter by status (new|moved in|moved out|no change)
  -o, --output <format>      output format: text|json|jsonl|csv|table (default:
                             "text")
  -h, --help                 display help for command

stats

Usage: tech-radar-volumes stats [options]

show statistics for the master dataset

Options:
  -b, --by <group>       group stats by: volume|quadrant|ring|all (default:
                         "all")
  -o, --output <format>  output format: text|json|jsonl|csv|table (default:
                         "text")
  -h, --help             display help for command