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
baseUrlandenableSPAsettings. - 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
quartzandvercelCLI 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: []