@mintlify/previewing 3.0.0

package/bin/util.js

@@ -0,0 +1,123 @@
+import { mkdirSync, writeFileSync } from "fs";
+import Ora from "ora";
+import path from "path";
+import shell from "shelljs";
+export const MintConfig = (name, color, ctaName, ctaUrl, filename) => {
+    return {
+        name,
+        logo: "",
+        favicon: "",
+        colors: {
+            primary: color,
+        },
+        topbarLinks: [],
+        topbarCtaButton: {
+            name: ctaName,
+            url: ctaUrl,
+        },
+        anchors: [],
+        navigation: [
+            {
+                group: "Home",
+                pages: [filename],
+            },
+        ],
+        // footerSocials: {}, // support object type for footer tyoes
+    };
+};
+export const Page = (title, description, markdown) => {
+    // If we are an empty String we want to add two quotes,
+    // if we added as we went we would detect the first quote
+    // as the closing quote.
+    const startsWithQuote = title.startsWith('"');
+    const endsWithQuote = title.startsWith('"');
+    if (!startsWithQuote) {
+        title = '"' + title;
+    }
+    if (!endsWithQuote) {
+        title = title + '"';
+    }
+    const optionalDescription = description
+        ? `\ndescription: "${description}"`
+        : "";
+    return `---\ntitle: ${title}${optionalDescription}\n---\n\n${markdown}`;
+};
+export function getOrigin(url) {
+    // eg. https://google.com -> https://google.com
+    // https://google.com/page -> https://google.com
+    return new URL(url).origin;
+}
+export function objToReadableString(objs) {
+    // Two spaces as indentation
+    return objs.map((obj) => JSON.stringify(obj, null, 2)).join(",\n");
+}
+export const toFilename = (title) => {
+    // Gets rid of special characters at the start and end
+    // of the name by converting to spaces then using trim.
+    return title
+        .replace(/[^a-z0-9]/gi, " ")
+        .trim()
+        .replace(/ /g, "-")
+        .toLowerCase();
+};
+export const addMdx = (fileName) => {
+    if (fileName.endsWith(".mdx")) {
+        return fileName;
+    }
+    return fileName + ".mdx";
+};
+export const createPage = (title, description, markdown, overwrite = false, rootDir = "", fileName) => {
+    const writePath = path.join(rootDir, addMdx(fileName || toFilename(title)));
+    // Create the folders needed if they're missing
+    mkdirSync(rootDir, { recursive: true });
+    // Write the page to memory
+    if (overwrite) {
+        writeFileSync(writePath, Page(title, description, markdown));
+        console.log("✏️ - " + writePath);
+    }
+    else {
+        try {
+            writeFileSync(writePath, Page(title, description, markdown), {
+                flag: "wx",
+            });
+            console.log("✏️ - " + writePath);
+        }
+        catch (e) {
+            // We do a try-catch instead of an if-statement to avoid a race condition
+            // of the file being created after we started writing.
+            if (e.code === "EEXIST") {
+                console.log(`❌ Skipping existing file ${writePath}`);
+            }
+            else {
+                console.error(e);
+            }
+        }
+    }
+};
+export const buildLogger = (startText = "") => {
+    const logger = Ora().start(startText);
+    return logger;
+};
+export const getFileExtension = (filename) => {
+    const ext = filename.substring(filename.lastIndexOf(".") + 1, filename.length);
+    if (filename === ext)
+        return undefined;
+    return ext;
+};
+export const fileBelongsInPagesFolder = (filename) => {
+    const extension = getFileExtension(filename);
+    return (extension &&
+        (extension === "mdx" || extension === "md" || extension === "tsx"));
+};
+export const ensureYarn = (logger) => {
+    const yarnInstalled = shell.which("yarn");
+    if (!yarnInstalled) {
+        logger.fail(`yarn must be installed, run
+
+    npm install --global yarn
+
+    `);
+        process.exit(1);
+    }
+};
+//# sourceMappingURL=util.js.map

package/bin/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,GAAuB,MAAM,KAAK,CAAC;AAC1C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAY,EACZ,KAAa,EACb,OAAe,EACf,MAAc,EACd,QAAgB,EAChB,EAAE;IACF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,EAAE;QACX,MAAM,EAAE;YACN,OAAO,EAAE,KAAK;SACf;QACD,WAAW,EAAE,EAAE;QACf,eAAe,EAAE;YACf,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,MAAM;SACZ;QACD,OAAO,EAAE,EAAE;QACX,UAAU,EAAE;YACV;gBACE,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,CAAC,QAAQ,CAAC;aAClB;SACF;QACD,6DAA6D;KAC9D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,KAAa,EACb,WAAoB,EACpB,QAAiB,EACjB,EAAE;IACF,uDAAuD;IACvD,yDAAyD;IACzD,wBAAwB;IACxB,MAAM,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,eAAe,EAAE;QACpB,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;KACrB;IACD,IAAI,CAAC,aAAa,EAAE;QAClB,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC;KACrB;IAED,MAAM,mBAAmB,GAAG,WAAW;QACrC,CAAC,CAAC,mBAAmB,WAAW,GAAG;QACnC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,eAAe,KAAK,GAAG,mBAAmB,YAAY,QAAQ,EAAE,CAAC;AAC1E,CAAC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,+CAA+C;IAC/C,gDAAgD;IAChD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAA2B;IAC7D,4BAA4B;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE;IAC1C,sDAAsD;IACtD,uDAAuD;IACvD,OAAO,KAAK;SACT,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,IAAI,EAAE;SACN,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,WAAW,EAAE,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAE,EAAE;IACzC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAC7B,OAAO,QAAQ,CAAC;KACjB;IACD,OAAO,QAAQ,GAAG,MAAM,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAa,EACb,WAAoB,EACpB,QAAiB,EACjB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,EAAE,EACZ,QAAiB,EACjB,EAAE;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5E,+CAA+C;IAC/C,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,2BAA2B;IAC3B,IAAI,SAAS,EAAE;QACb,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;KAClC;SAAM;QACL,IAAI;YACF,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;gBAC3D,IAAI,EAAE,IAAI;aACX,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;SAClC;QAAC,OAAO,CAAC,EAAE;YACV,yEAAyE;YACzE,sDAAsD;YACtD,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;aACtD;iBAAM;gBACL,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAClB;SACF;KACF;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,GAAG,EAAE,EAAW,EAAE;IACrD,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAC5B,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAC7B,QAAQ,CAAC,MAAM,CAChB,CAAC;IACF,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAgB,EAAE,EAAE;IAC3D,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,CACL,SAAS;QACT,CAAC,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,KAAK,CAAC,CACnE,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,EAAE;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,aAAa,EAAE;QAClB,MAAM,CAAC,IAAI,CAAC;;;;KAIX,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;AACH,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@mintlify/previewing",
+  "version": "3.0.0",
+  "description": "Preview Mintlify docs locally",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "Elastic-2.0",
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint . --cache"
+  },
+  "author": "Mintlify, Inc.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mintlify/mint",
+    "directory": "packages/mintlify-previewing"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": "./bin/index.js",
+  "bin": {
+    "mintlify-preview": "bin/index.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.0",
+    "@mintlify/validation": "^0.1.9",
+    "@octokit/rest": "^19.0.5",
+    "axios": "^1.2.2",
+    "chalk": "^5.1.0",
+    "cheerio": "^0.22.0",
+    "chokidar": "^3.5.3",
+    "favicons": "^7.0.1",
+    "fs-extra": "^11.1.0",
+    "gray-matter": "^4.0.3",
+    "inquirer": "^9.1.0",
+    "is-absolute-url": "^4.0.1",
+    "is-internet-available": "^3.1.0",
+    "minimist-lite": "^2.2.1",
+    "node-html-markdown": "^1.3.0",
+    "open": "^8.4.0",
+    "openapi-types": "^12.0.2",
+    "ora": "^6.1.2",
+    "puppeteer": "^19.4.0",
+    "remark": "^14.0.2",
+    "remark-frontmatter": "^4.0.1",
+    "remark-gfm": "^3.0.1",
+    "remark-mdx": "^2.2.1",
+    "shelljs": "^0.8.5",
+    "unist-util-visit": "^4.1.1",
+    "yargs": "^17.6.0"
+  },
+  "devDependencies": {
+    "@mintlify/eslint-config": "1.0.3",
+    "@mintlify/eslint-config-typescript": "1.0.7",
+    "@mintlify/ts-config": "1.0.7",
+    "@tsconfig/recommended": "1.x",
+    "@types/cheerio": "^0.22.31",
+    "@types/fs-extra": "^9.0.13",
+    "@types/inquirer": "^9.0.1",
+    "@types/node": "^18.7.13",
+    "@types/shelljs": "^0.8.11",
+    "@types/yargs": "^17.0.13",
+    "@typescript-eslint/eslint-plugin": "5.x",
+    "@typescript-eslint/parser": "5.x",
+    "eslint": "8.x",
+    "eslint-config-prettier": "8.x",
+    "eslint-plugin-unused-imports": "2.x",
+    "prettier": "2.x",
+    "typescript": "^4.8.2"
+  }
+}

package/scraper.md

@@ -0,0 +1,121 @@
+# CLI Scraping
+
+The CLI has many commands. This doc focuses on how we coded scraping websites.
+
+## User Interface
+
+There are two main commands:
+
+`mintlify scrape-page [url]`
+
+and
+
+`mintlify scrape-section [url]`
+
+Scraping a page downloads a single page’s content. Scraping a section goes through the navigation and scrapes each page. The code for downloading a page’s content is shared between the two commands.
+
+Important files: `scraping/scrapePageCommands.ts`, `scraping/scrapeSectionAutomatically.ts`
+
+We have `scrape-gitbook-page` and similar commands for debugging. Ignore them, they just call internal functions directly. You should not need to use them unless you are debugging issues with Detecting Frameworks.
+
+## Overwriting
+
+The user has to add a `--overwrite` flag if they want to overwrite their current files.
+
+## Sections vs Websites
+
+We call the command `scrape-section` instead of `scrape-website` because we cannot scrape pages not in the navigation of the URL first passed in. For example, ReadMe has API Reference and other sections accessible through a separate top-navigation which we do not parse. We only scrape the navigation on the left: [https://docs.readme.com/main/docs](https://docs.readme.com/main/docs)
+
+## Detecting Frameworks
+
+The commands look in the page HTML to detect what framework scraper to use. For example, all Docusaurus sites have a metatag with the word Docusaurus in it. Some times, the metatag even has the Docusaurus version.
+
+Each framework’s scrapers live in `scraping/site-scrapers/`
+
+We currently support:
+
+- Docusaurus
+- GitBook
+- ReadMe
+- Intercom
+
+## Terminal Output
+
+We print a line in the terminal for every file we write. `util.ts` has a createPage function that takes care of writing the file and logging.
+
+We use a pencil emoji when we successfully write a file. Images get a picture emoji. Likewise, we print a X emoji when we find a file that already exists and the user has not enabled overwriting files. We use emojis so you can tell what the command is doing without reading each file path.
+
+We also print the file paths when scraping sections so the user can easily copy paste them into mint.json. Note that pages the user already added in Mintlify are not included in the printed example. We do not generate mint.json completely, we are just giving a small example to help users starting from scratch.
+
+```jsx
+Add the following to your navigation in mint.json:
+
+{
+   "group": "Guides",
+   "pages": ["page-we-scraped"]
+}
+```
+
+# Navigation Scraping
+
+Most sites use JavaScript to open navigation menus which do not automatically include the menu buttons in the HTML. We use Puppeteer to click every nested menu so the site adds the menu buttons to the HTML. For example the original site’s HTML:
+
+```jsx
+<div>
+  <a id="my-nested-menu"></a>
+</div>
+```
+
+can turn into this after opening the nested menu:
+
+```jsx
+<div>
+  <a id="my-nested-menu" aria-expanded=true></a>
+  <div>
+     <a href="/page"></a>
+     <a href="/other-page"></a>
+  </div>
+</div>
+```
+
+Ultimately, all section scrapers need to find an array of links to visit then call the scrape page function in a loop.
+
+We use axios instead of Puppeteer if a site doesn’t hide links. Puppeteer is slow.
+
+# Image File Locations
+
+Images go in an `images/` folder because that’s what most users want. Scraping per section uses the same root-level images folder. Scraping per page downloads them to the current location. Thus, scraping a single page from a folder means the user always has to move the images themselves. That’s a trade-off we are comfortable with — trying to detect an existing images folder gets too complicated too fast.
+
+# Cheerio
+
+Cheerio is a library to scrape/handle the HTML after we have it in a string. Most of the work is using inspect-element to view a website and figure out where the content we want is, then writing the corresponding Cheerio code.
+
+# HTML to MDX
+
+We use an open-source library to convert HTML to Markdown: https://github.com/crosstype/node-html-markdown
+
+The `util.ts` createPage function assembles the MDX metadata, we just need to return an object of the form `{ title, description, content }` from each page scraper.
+
+## Parsing Issues
+
+Parsing struggles when documentation websites are using non-standard HTML. For example, code blocks are supposed to use. `<pre><code></code></pre>` but GitBook just uses divs.
+
+We can write custom translators for the library that determine how we parse certain objects.
+
+In some cases, we will want custom translators even if parsing succeeds. For example, ReadMe callouts are using quote syntax
+
+```jsx
+> 💡
+> Callout text
+>
+```
+
+When we want to convert them to:
+
+```jsx
+<Tip>Callout text</Tip>
+```
+
+## Regex
+
+You can use regex to make small changes where translators are overkill or there’s no obvious component to modify. For example, here’s the end of `scrapeDocusaurusPage.ts`:

package/src/constants.ts

@@ -0,0 +1,40 @@
+import path from "path";
+import * as url from "url";
+import os from "os";
+
+// Change this to bump to a newer version of mint's client
+export const TARGET_MINT_VERSION = "v0.0.9";
+
+// package installation location
+export const INSTALL_PATH = url.fileURLToPath(new URL(".", import.meta.url));
+
+export const HOME_DIR = os.homedir();
+
+export const DOT_MINTLIFY = path.join(HOME_DIR, ".mintlify");
+
+export const VERSION_PATH = path.join(DOT_MINTLIFY, "mint", "mint-version.txt");
+
+export const CLIENT_PATH = path.join(DOT_MINTLIFY, "mint", "client");
+
+export const MINT_PATH = path.join(DOT_MINTLIFY, "mint");
+
+// command execution location
+export const CMD_EXEC_PATH = process.cwd();
+
+export const SUPPORTED_MEDIA_EXTENSIONS = [
+  "jpeg",
+  "jpg",
+  "jfif",
+  "pjpeg",
+  "pjp",
+  "png",
+  "svg",
+  "svgz",
+  "ico",
+  "webp",
+  "gif",
+  "apng",
+  "avif",
+  "bmp",
+  "mp4",
+];

package/src/downloadImage.ts

@@ -0,0 +1,102 @@
+import { existsSync, mkdirSync, createWriteStream } from "fs";
+import path from "path";
+import axios from "axios";
+import { getFileExtension } from "./util.js";
+import { SUPPORTED_MEDIA_EXTENSIONS } from "./constants.js";
+
+async function writeImageToFile(
+  imageSrc: string,
+  writePath: string,
+  overwrite: boolean
+) {
+  // Avoid unnecessary downloads
+  if (existsSync(writePath) && !overwrite) {
+    return Promise.reject({
+      code: "EEXIST",
+    });
+  }
+
+  // Create the folders needed if they're missing
+  mkdirSync(path.dirname(writePath), { recursive: true });
+
+  const writer = createWriteStream(writePath);
+
+  try {
+    const response = await axios.get(imageSrc, {
+      responseType: "stream",
+    });
+    // wx prevents overwriting an image with the exact same name
+    // being created in the time we were downloading
+    response.data.pipe(writer, {
+      flag: "wx",
+    });
+
+    return new Promise((resolve, reject) => {
+      writer.on("finish", resolve);
+      writer.on("error", reject);
+    });
+  } catch (e) {
+    return Promise.reject({
+      code: "ENOTFOUND",
+    });
+  }
+}
+
+export function isValidImageSrc(src: string) {
+  if (!src) {
+    return false;
+  }
+  // We do not support downloading base64 in-line images.
+  if (src.startsWith("data:")) {
+    return false;
+  }
+
+  const imageHref = removeMetadataFromImageSrc(src);
+  const ext = getFileExtension(imageHref);
+
+  if (ext && !SUPPORTED_MEDIA_EXTENSIONS.includes(ext)) {
+    console.error("🚨 We do not support the file extension: " + ext);
+    return false;
+  }
+
+  return true;
+}
+
+export function removeMetadataFromImageSrc(src: string) {
+  // Part of the URL standard
+  const metadataSymbols = ["?", "#"];
+
+  metadataSymbols.forEach((dividerSymbol) => {
+    // Some frameworks add metadata after the file extension, we need to remove that.
+    src = src.split(dividerSymbol)[0];
+  });
+
+  return src;
+}
+
+export function cleanImageSrc(src: string, origin: string) {
+  // Add origin if the image tags are using relative sources
+  return src.startsWith("http") ? src : new URL(src, origin).href;
+}
+
+export default async function downloadImage(
+  imageSrc: string,
+  writePath: string,
+  overwrite = false
+) {
+  await writeImageToFile(imageSrc, writePath, overwrite)
+    .then(() => {
+      console.log("🖼️ - " + writePath);
+    })
+    .catch((e) => {
+      if (e.code === "EEXIST") {
+        console.log(`❌ Skipping existing image ${writePath}`);
+      } else if (e.code === "ENOTFOUND") {
+        console.error(
+          `🚨 Cannot download the image, address not found ${imageSrc}`
+        );
+      } else {
+        console.error(e);
+      }
+    });
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/* eslint-disable @typescript-eslint/no-empty-function */
+
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers.js";
+import dev from "./local-preview/index.js";
+import installDepsCommand from "./local-preview/helper-commands/installDepsCommand.js";
+
+yargs(hideBin(process.argv))
+  .command(
+    "dev",
+    "Runs Mintlify locally (Must run in directory with mint.json)",
+    () => {},
+    async (argv) => {
+      await dev(argv);
+    }
+  )
+  .command(
+    "install",
+    "Install dependencies for local Mintlify",
+    () => {},
+    installDepsCommand
+  )
+  // Print the help menu when the user enters an invalid command.
+  .strictCommands()
+  .demandCommand(
+    1,
+    "Unknown command. See above for the list of supported commands."
+  )
+
+  // Alias option flags --help = -h, --version = -v
+  .alias("h", "help")
+  .alias("v", "version")
+
+  .parse();

package/src/local-preview/helper-commands/installDepsCommand.ts

@@ -0,0 +1,13 @@
+import shell from "shelljs";
+import { CLIENT_PATH } from "../../constants.js";
+import { buildLogger, ensureYarn } from "../../util.js";
+
+const installDeps = async () => {
+  const logger = buildLogger("");
+  ensureYarn(logger);
+  shell.cd(CLIENT_PATH);
+  shell.exec("yarn");
+  logger.succeed("Dependencies installed.");
+};
+
+export default installDeps;