Configured Quartz and Vercel for SPA Deployment

📅 2025-07-30 — Session: Configured Quartz and Vercel for SPA Deployment

🕒 12:55–13:20
🏷️ Labels: Quartz, Vercel, SPA, Configuration, Deployment
📂 Project: Dev
⭐ Priority: MEDIUM

Session Goal:

The goal of this session was to address and resolve configuration issues related to deploying a Quartz static site generator on Vercel, specifically focusing on custom domain settings and Single Page Application (SPA) routing.

Key Activities:

• Base URL Issue Fix: Steps were outlined to resolve a base URL issue in the Quartz build configuration to ensure internal links work correctly on a custom domain.
• Custom Domain Configuration: Guidance was provided on configuring Quartz for a custom domain, addressing common pitfalls with baseUrl and enableSPA settings.
• SPA Routing Troubleshooting: Troubleshooting steps were discussed for resolving SPA routing issues on Vercel, including configuration options and verification methods.
• Vercel SPA Configuration: A detailed solution was provided for configuring Vercel to support SPA by adding a rewrite rule in vercel.json.
• CLI Command Fixes: Addressed command not found errors for quartz and vercel CLI tools, providing actionable fixes.

Achievements:

• Successfully configured Quartz with a custom domain and SPA settings on Vercel.
• Resolved routing issues and ensured proper functioning of internal links.
• Implemented CLI command fixes for Quartz and Vercel.

Pending Tasks:

• Verify the deployment on Vercel to ensure all configurations are correctly applied and functioning as expected.