fix(apps): add proper docs URL to all apps 🎉

src/commands/install/config/apps-groups/apps.ts

@@ -1,5 +1,12 @@
 import type { IAppSetup } from '@models/app-setup.model'
-import { BREW_CASK, BREW_INSTALL, BROW_CASK, OPEN_APP_STORE_APP_LINK, OPEN_BROWSER_LINK } from '../common-commands'
+import {
+    BREW_CASK,
+    BREW_HOME,
+    BREW_INSTALL,
+    BROW_CASK,
+    OPEN_APP_STORE_APP_LINK,
+    OPEN_BROWSER_LINK,
+} from '../common-commands'
 
 export const APPS: Readonly<IAppSetup[]> = [
     {
@@ -8,6 +15,7 @@ export const APPS: Readonly<IAppSetup[]> = [
         description: 'Productivity app, create custom shortcuts and workflows (paid)',
         tags: ['productivity'],
         paid: true,
+        openUrl: () => BREW_HOME('alfred', true),
         commands: () => [BREW_CASK('alfred')],
     },
     {
@@ -16,50 +24,59 @@ export const APPS: Readonly<IAppSetup[]> = [
         description: 'Hide menu bar icons and manage them (paid)',
         tags: ['productivity'],
         paid: true,
+        openUrl: () => BREW_HOME('bartender', true),
         commands: () => [BREW_CASK('bartender')],
     },
     {
         name: 'Google Drive',
         description: 'Cloud storage service by Google (password needed)',
         group: 'apps',
         default: true,
+        openUrl: () => BREW_HOME('google-drive', true),
         commands: () => [BREW_CASK('google-drive')],
     },
     {
         name: 'Rectangle',
         group: 'apps',
         description: 'Move and resize windows in macOS using keyboard shortcuts',
         tags: ['productivity'],
+        openUrl: () => BREW_HOME('rectangle', true),
         commands: () => [BREW_CASK('rectangle')],
     },
     {
         name: 'MonitorControl',
         group: 'apps',
         description: 'Tool to control external monitor brightness and volume',
+        openUrl: () => BREW_HOME('monitorcontrol', true),
         commands: () => [BREW_CASK('monitorcontrol')],
     },
     {
         name: 'Slack',
         group: 'apps',
         tags: ['work'],
+        openUrl: () => BREW_HOME('slack', true),
         commands: () => [BREW_CASK('slack')],
     },
     {
         name: 'UTM',
         group: 'apps',
         description: 'Virtual machine MacOS',
+        openUrl: () => BREW_HOME('utm', true),
         commands: () => [BREW_CASK('utm')],
     },
     {
         name: '1Password',
         group: 'apps',
         tags: ['personal', 'work'],
+        paid: true,
+        openUrl: () => BREW_HOME('1password', true),
         commands: () => [BREW_CASK('1password')],
     },
     {
         name: 'Grammarly',
         group: 'apps',
         default: true,
+        openUrl: () => BREW_HOME('grammarly-desktop', true),
         commands: () => [BREW_CASK('grammarly-desktop')],
     },
     {
@@ -68,6 +85,7 @@ export const APPS: Readonly<IAppSetup[]> = [
         group: 'apps',
         tags: ['productivity'],
         paid: true,
+        openUrl: () => BREW_HOME('cleanshot', true),
         commands: () => [BREW_CASK('cleanshot')],
     },
     {
@@ -76,6 +94,7 @@ export const APPS: Readonly<IAppSetup[]> = [
         group: 'apps',
         tags: ['super-user'],
         paid: true,
+        openUrl: () => `open https://pasteapp.io/`,
         commands: () => [OPEN_APP_STORE_APP_LINK('paste-endless-clipboard/id967805235')],
     },
     {
@@ -84,6 +103,7 @@ export const APPS: Readonly<IAppSetup[]> = [
         group: 'apps',
         tags: ['super-user'],
         paid: true,
+        openUrl: () => `open https://lowtechguys.com/rcmd/`,
         commands: () => [OPEN_APP_STORE_APP_LINK('rcmd-app-switcher/id1596283165')],
     },
     {
@@ -98,6 +118,7 @@ export const APPS: Readonly<IAppSetup[]> = [
         description: 'Easy window resize & organize',
         group: 'apps',
         tags: ['super-user'],
+        openUrl: () => `open https://folivora.ai/bettersnaptool`,
         commands: () => [OPEN_APP_STORE_APP_LINK('bettersnaptool/id417375580')],
     },
     {
@@ -106,20 +127,23 @@ export const APPS: Readonly<IAppSetup[]> = [
         group: 'apps',
         tags: ['productivity'],
         paid: true,
+        openUrl: () => BREW_HOME('textsniper', true),
         commands: () => [BREW_CASK('textsniper')],
     },
     {
         name: 'Rocket',
         description: 'Emoji shortcuts for faster typing',
         group: 'apps',
         tags: ['productivity'],
+        openUrl: () => BREW_HOME('rocket', true),
         commands: () => [BREW_CASK('rocket')],
     },
     {
         name: 'TinkerTool',
         description: 'Access hidden system settings on macOS',
         group: 'apps',
         tags: ['super-user'],
+        openUrl: () => `open https://www.bresink.com/osx/TinkerTool.html`,
         commands: () => [OPEN_BROWSER_LINK('https://www.bresink.com/osx/0TinkerTool/download.php')],
     },
     {
@@ -128,31 +152,36 @@ export const APPS: Readonly<IAppSetup[]> = [
         group: 'apps',
         tags: ['super-user'],
         paid: true,
+        openUrl: () => `open https://dropoverapp.com/`,
         commands: () => [OPEN_APP_STORE_APP_LINK('dropover-easier-drag-drop/id1355679052')],
     },
     {
         name: 'Hovrly',
         description: 'Easily see time zones in your menu bar',
         group: 'apps',
+        openUrl: () => BREW_HOME('hovrly'),
         commands: () => [BREW_INSTALL('hovrly')],
     },
     {
         name: 'Notion',
         group: 'apps',
         tags: ['productivity'],
+        openUrl: () => BREW_HOME('notion', true),
         commands: () => [BREW_CASK('notion')],
     },
     {
         name: 'WhatsApp',
         group: 'apps',
         tags: ['personal'],
+        openUrl: () => BREW_HOME('whatsapp', true),
         commands: () => [BREW_CASK('whatsapp')],
         fallbackCommands: () => [BROW_CASK('whatsapp')],
     },
     {
         name: 'WhatsApp (legacy)',
         description: 'WhatsApp legacy version',
         group: 'apps',
+        openUrl: () => BREW_HOME('whatsapp', true),
         commands: () => [
             BREW_CASK(
                 'https://raw.githubusercontent.com/Homebrew/homebrew-cask/2f428f0d63c346637aafd8a8b2f474670c2e42f1/Casks/w/whatsapp.rb',
@@ -168,20 +197,23 @@ export const APPS: Readonly<IAppSetup[]> = [
         name: 'Telegram',
         group: 'apps',
         tags: ['personal'],
+        openUrl: () => BREW_HOME('telegram', true),
         commands: () => [BREW_CASK('telegram')],
         fallbackCommands: () => [BROW_CASK('telegram')],
     },
     {
         name: 'Dash',
         group: 'apps',
         description: 'Documentation browser',
+        openUrl: () => BREW_HOME('dash', true),
         commands: () => [BREW_CASK('dash')],
     },
     {
         name: 'Vivid',
         group: 'apps',
         description: 'Unlocks the full brightness of your MacBook Pro (paid)',
         paid: true,
+        openUrl: () => BREW_HOME('vivid', true),
         commands: () => [BREW_CASK('vivid')],
     },
 ] as const

src/commands/install/config/apps-groups/cli-apps.ts

@@ -1,6 +1,7 @@
 import type { IAppSetup } from '@models/app-setup.model'
 import {
     BREW_CASK,
+    BREW_HOME,
     BREW_INSTALL,
     BREW_TAP,
     BROW_ALIAS,
@@ -18,6 +19,7 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         description: 'Node Version Manager (password needed)',
         group: 'cli-apps',
         tags: ['node-engineering', 'web-engineering', 'devops'],
+        openUrl: () => BREW_HOME('nvm'),
         commands: () => [
             BREW_INSTALL('nvm'),
             '\\. "$(brew --prefix)/opt/nvm/nvm.sh"',
@@ -38,6 +40,7 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         group: 'cli-apps',
         description: 'GitHub in your terminal',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('gh'),
         commands: () => [BREW_INSTALL('gh')],
         fallbackCommands: () => [BROW_INSTALL('gh')],
     },
@@ -46,6 +49,7 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         group: 'cli-apps',
         description: 'Integrate with Google Cloud Platform services (Python required)',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('google-cloud-sdk'),
         commands: () => [BREW_CASK('google-cloud-sdk')],
         fallbackCommands: () => [BROW_CASK('google-cloud-sdk')],
         deps: ['Python'],
@@ -55,6 +59,7 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         group: 'cli-apps',
         description: 'Official Amazon AWS command-line interface (Python required)',
         tags: ['devops'],
+        openUrl: () => BREW_HOME('awscli'),
         commands: () => [BREW_INSTALL('awscli')],
         deps: ['Python'],
     },
@@ -63,13 +68,15 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         group: 'cli-apps',
         description: 'Kubernetes CLI, Switch faster between Kubernetes contexts and namespaces',
         tags: ['devops'],
+        openUrl: () => BREW_HOME('kubectx'),
         commands: () => [BREW_INSTALL('kubectx')],
     },
     {
         name: 'Mongodb',
         group: 'cli-apps',
         description: 'MongoDB Community Edition server',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('mongodb-community@6.0'),
         commands: () => [BREW_TAP('mongodb/brew'), BREW_INSTALL('mongodb-community@6.0'), 'mkdir -p "$HOME/mongodb"'],
         fallbackCommands: () => [
             BROW_TAP('mongodb/brew'),
@@ -82,6 +89,7 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         description: 'Redis server',
         group: 'cli-apps',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('redis'),
         commands: () => [BREW_INSTALL('redis')],
         fallbackCommands: () => [BROW_INSTALL('redis')],
     },
@@ -90,26 +98,30 @@ export const CLI_APPS: Readonly<IAppSetup[]> = [
         description: 'Docker CLI',
         group: 'cli-apps',
         tags: ['node-engineering', 'devops'],
+        openUrl: () => BREW_HOME('docker'),
         commands: () => [BREW_INSTALL('docker')],
     },
     {
         name: 'Terraform',
         description: 'Terraform CLI',
         group: 'cli-apps',
         tags: ['devops'],
+        openUrl: () => BREW_HOME('terraform'),
         commands: () => [BREW_INSTALL('terraform')],
     },
     {
         name: 'Kubernetes Helm',
         description: 'Kubernetes package manager',
         group: 'cli-apps',
         tags: ['devops'],
+        openUrl: () => BREW_HOME('helm'),
         commands: () => [BREW_INSTALL('helm')],
     },
     {
         name: 'Btop',
         description: 'Resource monitor over the terminal',
         group: 'cli-apps',
+        openUrl: () => BREW_HOME('btop'),
         commands: () => [BREW_INSTALL('btop')],
     },
 ] as const

src/commands/install/config/apps-groups/engineering-apps.ts

@@ -1,19 +1,21 @@
 import type { IAppSetup } from '@models/app-setup.model'
-import { BREW_CASK } from '../common-commands'
+import { BREW_CASK, BREW_HOME } from '../common-commands'
 
 export const ENGINEERING_APPS: Readonly<IAppSetup[]> = [
     {
         name: 'Mongodb Compass',
         description: 'MongoDB GUI, MongoDB is required',
         group: 'engineering-apps',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('mongodb-compass', true),
         commands: () => [BREW_CASK('mongodb-compass')],
     },
     {
         name: 'Another Redis Desktop Manager',
         description: 'Redis GUI, Redis is required (password needed)',
         group: 'engineering-apps',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('another-redis-desktop-manager', true),
         commands: () => [
             BREW_CASK('another-redis-desktop-manager'),
             `sudo xattr -rd com.apple.quarantine "/Applications/Another Redis Desktop Manager.app"`,
@@ -23,13 +25,15 @@ export const ENGINEERING_APPS: Readonly<IAppSetup[]> = [
         name: 'Rancher',
         description: 'Kubernetes and Docker UI tool',
         group: 'engineering-apps',
+        openUrl: () => BREW_HOME('rancher', true),
         commands: () => [BREW_CASK('rancher')],
     },
     {
         name: 'Postman',
         description: 'API client',
         group: 'engineering-apps',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('postman', true),
         commands: () => [BREW_CASK('postman')],
     },
 ]

src/commands/install/config/apps-groups/git.ts

@@ -1,19 +1,22 @@
 import type { IAppSetup } from '@models/app-setup.model'
-import { BREW_INSTALL } from '../common-commands'
+import { BREW_HOME, BREW_INSTALL } from '../common-commands'
 
 export const GIT_APPS: Readonly<IAppSetup[]> = [
     {
         name: 'Git',
         description: 'Common Code Version Manager',
         group: 'git',
         tags: ['engineering'],
+        openUrl: () => BREW_HOME('git'),
         commands: () => [BREW_INSTALL('git')],
     },
     {
         name: 'VSCode as rebase editor',
         description: 'Apply rebase with VSCode UI editor (Git required)',
         group: 'git',
         tags: ['super-user'],
+        openUrl: () =>
+            `open https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration#:~:text=documentation%20mentioned%20above.-,core.editor,-By%20default%2C%20Git`,
         commands: () => [
             `git config --global core.editor "/Applications/Visual\\ Studio\\ Code.app/Contents/Resources/app/bin/code --wait"`,
         ],
@@ -24,6 +27,7 @@ export const GIT_APPS: Readonly<IAppSetup[]> = [
         description: 'Enable reuse recorded resolution for merge conflicts (Git required)',
         group: 'git',
         tags: ['super-user'],
+        openUrl: () => `open https://git-scm.com/book/en/v2/Git-Tools-Rerere`,
         commands: () => [
             // avoid lock for other `git config` options
             'sleep 1',
@@ -35,6 +39,7 @@ export const GIT_APPS: Readonly<IAppSetup[]> = [
         name: 'Increase credential cache timeout',
         description: 'Increase the cache time for using your credentials from Keychain - 1 month (Git required)',
         group: 'git',
+        openUrl: () => `open https://git-scm.com/docs/git-credential-cache`,
         commands: () => [
             // avoid lock for other `git config` options
             'sleep 2',
@@ -47,6 +52,7 @@ export const GIT_APPS: Readonly<IAppSetup[]> = [
         description: 'Automatically setup remote tracking branches on git push (Git required)',
         group: 'git',
         tags: ['productivity'],
+        openUrl: () => `open https://git-scm.com/docs/git-push#Documentation/git-push.txt-pushautoSetupRemote`,
         commands: () => [
             // avoid lock for other `git config` options
             'sleep 3',