Resolved Yarn and Deployment Issues in Docusaurus

📅 2025-08-03 — Session: Resolved Yarn and Deployment Issues in Docusaurus

🕒 00:15–23:50
🏷️ Labels: Yarn, Docusaurus, Deployment, Build Processes, Vercel
📂 Project: Dev
⭐ Priority: MEDIUM

Session Goal

The session aimed to address and resolve multiple technical issues related to software development, specifically focusing on deployment and build processes using Docusaurus and Yarn.

Key Activities

• Updated the ‘My Deployments’ page to highlight significant projects like the PhD thesis online and the M.I. Journal.
• Resolved a Yarn build directory error in a Docusaurus project by diagnosing the issue and providing a step-by-step resolution.
• Diagnosed a Yarn build failure in Docusaurus, focusing on custom scripts and environment checks.
• Fixed a lint-staged error encountered during a Git commit by diagnosing the absence of the binary and offering multiple resolution options.
• Addressed Yarn CLI issues on Debian by uninstalling the Debian package and installing the official version to ensure proper command functionality.
• Resolved Yarn path issues with Corepack by ensuring the shell uses the correct Corepack-managed Yarn version.
• Configured Vercel deployment settings for Quartz projects, including specifying the root directory, build command, output directory, and install command.

Achievements

• Successfully updated deployment pages and resolved several build and deployment-related issues, ensuring smoother development workflows.

Pending Tasks

• Further testing of the deployment settings on Vercel to ensure compatibility with all project requirements.
• Continuous monitoring of Yarn and Docusaurus integration to preemptively catch similar issues in the future.