topics:

#
# Tools
#

  - topic: "brew"
    docs:
      - "https://brew.sh"
    snippets:
      - '/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)'
      - "brew outdated | xargs brew upgrade"

  - topic: "vscode"
    docs:
      - "https://code.visualstudio.com/"

  - topic: "git"
    docs:
      - "https://git-scm.com/docs"
    snippets:
      - "brew install git"
      - "git config --global pager.branch false"
      - "git diff --name-only --diff-filter=U"
      - "git checkout -b <BRANCH>"
      - "git clean -xdf"

  - topic: "gh"
    docs:
      - "https://cli.github.com/manual"
    snippets:
      - "brew install gh"
      - "gh config set pager cat"
      - "gh repo list --limit 999"
      - "gh pr list"

  - topic: "nodenv"
    docs:
      - "https://github.com/nodenv/nodenv"
    snippets:
      - "brew install nodenv"
      - "nodenv versions"

  - topic: "npm"
    docs:
      - "https://docs.npmjs.com/downloading-and-installing-node-js-and-npm"
    snippets:
      - "npm search --json --searchlimit 999 dxos | jq -r '.[] | [.name, .version]'"
      - "npx npm-check-updates -u --deep '@dxos/*'"

  - topic: "rush"
    docs:
      - "https://rushjs.io/pages/commands/rush_add"
    snippets:
      - "npm install -g @microsoft/rush"
      - "rush add -p <PACKAGE>"
      - "rush build --only <PACKAGE> | ."
      - "rush build --to <PACKAGE> | ."
      - "rush list"
      - "ncu --dep -u <PACKAGE>"

  - topic: "xcode"
    docs:
      - "https://developer.apple.com/xcode"
    snippets:
      - "xcode-select --install"

  - topic: "yarn"
    snippets:
      - "curl -o- -L https://yarnpkg.com/install.sh | bash"

#
# Themes
#

  - topic: "DXOS"
    docs:
      - "https://dxos.org"
      - "https://github.com/orgs/dxos/projects"
      - "https://github.com/dxos/eng/tree/main/docs/content"
      - "https://github.com/dxos/cli"

  - topic: "Javascript"
    docs:
      - "https://developer.mozilla.org/en-US/docs/Web/API"

  - topic: "Material UI (Mui)"
    docs:
      - "https://mui.com/components"
      - "https://mui.com/customization/default-theme"
      - "https://mui.com/components/material-icons"

  - topic: "Protocol buffers (protobuf)"
    docs:
      - "https://developers.google.com/protocol-buffers/docs/reference/proto3-spec"

  - topic: "React"
    docs:
      - "https://reactjs.org/docs/hooks-reference.html"

  - topic: "Regular expressions (Regexp)"
    docs:
      - "https://regex101.com"

  - topic: "Typescript (TS)"
    docs:
      - "https://www.typescriptlang.org/docs"

  - topic: "Webstorm"
    docs:
      - "https://www.jetbrains.com/help/webstorm/meet-webstorm.html"