Configured Quartz and Vercel for SPA Deployment

  • Day: 2025-07-30
  • Time: 12:55 to 13:20
  • Project: Dev
  • Workspace: WP 2: Operational
  • Status: Completed
  • Priority: MEDIUM
  • Assignee: Matías Nehuen Iglesias
  • Tags: Quartz, Vercel, SPA, Configuration, Deployment

Description

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.

Evidence

  • source_file=2025-07-30.sessions.jsonl, line_number=6, event_count=0, session_id=aa982f55aec5d392f61154ad8bf3ee73077369998b8b81021960f07707187aea
  • event_ids: []