Changing the Quartz Project URL

As a Systems Analyst, you know that renaming a project involves updating several “pointers” to avoid broken links and deployment errors. Follow these steps in order:

Step 1: Update Quartz Configuration

The Quartz engine needs to know its new identity to generate internal links and SEO metadata correctly.

1. Open quartz.config.ts in Neovim.
2. Locate the baseUrl field inside the configuration block.
3. Change it to your new desired URL (e.g., new-name.pages.dev).
4. Save the file.

Step 2: Rename the GitHub Repository

1. Go to your repository settings on GitHub.
2. Change the Repository Name.
3. Crucial: Update your local remote URL on your Fedora terminal:

   git remote set-url origin [https://github.com/rmelojs/NEW-REPO-NAME.git](https://github.com/rmelojs/NEW-REPO-NAME.git)

Step 3: Rename the Cloudflare Pages Project

Cloudflare controls the actual .pages.dev subdomain.

1. Log into the Cloudflare Dashboard.
2. Navigate to Workers & Pages > Select your project.
3. Go to Settings > General > Project name.
4. Click Change project name and enter the new name.
   • Note: This will immediately change your live URL.

Step 4: Sync and Final Push

Now that both the “source” (GitHub) and the “host” (Cloudflare) are aware of the change, push the configuration update:

git add .
git commit -m "infra: update baseUrl to match new project name"
git push origin v4

⚠️ Important Note on Links

Renaming the project will break the old .pages.dev link. If you have shared the previous URL, it will now return a 404. For a more permanent solution that survives project renames, consider setting up a Custom Domain (like docs.rmelo.js).