A garden should be your own
At its core, Quartz is designed to be easy to use enough for non-technical people to get going but also powerful enough that senior developers can tweak it to work how they’d like it to work.
- If you like the default configuration of Quartz and just want to change the content, the only thing that you need to change is the contents of the
content folder.
- If you’d like to make basic configuration tweaks but don’t want to edit source code, one can tweak the plugins and components in
quartz.config.ts and quartz.layout.ts in a guided manner to their liking.
- If you’d like to tweak the actual source code of the underlying plugins, components, or even build process, Quartz purposefully ships its full source code to the end user to allow customization at this level too.
Most software either confines you to either
- Makes it easy to tweak content but not the presentation
- Gives you too many knobs to tune the presentation without good opinionated defaults
Quartz should feel powerful but ultimately be an intuitive tool fully within your control. It should be a piece of agentic software. Ultimately, it should have the right affordances to nudge users towards good defaults but never dictate what the ‘correct’ way of using it is.