"Quartz v5 not detected" despite valid v5 repository structure

[martic97]

Quartz Syncer reports "Quartz v5 not detected" / "Your Quartz site uses the v4 configuration format" even though the repository has a valid Quartz v5 setup.

Repository details:

• quartz.config.yaml is present in the repository root (correct v5 YAML format, not quartz.config.ts)
• package.json declares "version": "5.0"
• package.json devDependencies include @quartz-community/types and @quartz-community/utils
• quartz.lock.json is present in the repository root and is not excluded in .gitignore
• Template used: TTRPG (via npx quartz create)
• Branch: v5 (set as default branch, correctly configured in Quartz Syncer's Git Repository settings)

Steps to reproduce:

1. Set up a Quartz v5 site using npx quartz create with the TTRPG template
2. Push to GitHub on the v5 branch
3. Install and configure Quartz Syncer in Obsidian, pointing to the repository and v5 branch
4. Git Repository connection shows read/write: ok
5. Under Quartz configuration, it still shows "Quartz v5 not detected"

Additional note:
The error message suggests running npx quartz migrate to fix this, but this command does not exist in the Quartz CLI — running it returns Unknown argument: migrate (confirmed against Quartz's own --help output, which only lists create, upgrade, restore, sync, build, tui, plugin).

Happy to share the repository or more details if helpful for debugging.

[saberzero1]

Please share the repository.

[martic97]

Here's the repository: https://github.com/martic97/dayatma (branch: v5).
I'm pretty new to Obsidian and Quartz so let me know if there are any mistakes on my part that I can solve.
Thanks for the help!

[RiiaC]

I have the same problem

The problem is with this repository: https://github.com/RiiaC/Kareinas-blog

I created this repository today

• I followed the instructions at https://saberzero1.github.io/quartz-syncer-docs/guides/github-setup
• The blog was created at https://riiac.github.io/Kareinas-blog/ but it doesn't show the quartz community footers that exist in quartz.config.ymal
• The main Quartz Syncer settings Git page thinks I can read and write:

- but the Quartz page thinks I don't have v5:

I tried:

Beacuse the Quartz Syncer > settings > Quartz error message included a suggested solution, I tried:

PS C:\Obsidian files\Quartz-Kareinas-blog> npx quartz migrate

which gave:

quartz <cmd> [args]

Commands:
  quartz create               Initialize Quartz
  quartz upgrade              Upgrade Quartz to the latest version
                                                               [aliases: update]
  quartz restore              Try to restore your content folder from the cache
  quartz sync                 Sync your Quartz to and from GitHub.
  quartz build                Build Quartz into a bundle of static HTML files
  quartz tui                  Launch interactive plugin manager
  quartz plugin [subcommand]  Manage Quartz plugins

Options:
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]

Unknown argument: migrate
PS C:\Obsidian files\Quartz-Kareinas-blog>`

advice appreciated

Thanks for all of your work making this, and then troubleshooting when we stumble upon problems, possibly of our own making.

other potentially useful information:

• my Quartz Syncer version: 1.15.3
• my Obsidian version: 1.12.7
• installer version: 1.8.10
• my operating system: Windows 11, version 25H2

[RiiaC]

Follow up to my above comment:

I tried re-creating the Quartz repository for my blog from scratch today, but still get the same version 4 error. I then updated the quartz syncer plugin, so now:

Quartz Syncer version is 1.18.0
Obsidian version is 1.13.4

but the Quartz Syncer settings page still shows that it thinks I have quartz version 4:

Which means that I can't use quartz sync to push to GitHub, so the published version of my blog, created today when I ran the Setup Wizard, still includes the folder "unpublished", which is the only folder in the obsidian vault to have the property published : false, and thus won't publish once sync works.

What can I do to fix this issue?