Skip to content

QuartzControl 1.0.0

Choose a tag to compare

View all tags
@boxi-os boxi-os released this 24 Sep 22:11
· 385 commits to main since this release
v1.0.0
f98a991

The first stable version. Since the release candidate the Styles page and the templates got the
most attention — variables, the project image in the header, the custom CSS helpers — and every
list now removes an entry the same way. Feedback is welcome — an issue is the easiest way.

Coming from beta 2

If you edit a project on more than one machine (Git sync), update every machine first and only
then open the project with the new version. The first save on the Styles page renames the markers
in custom.scss (Quartz-GUI:managed: → QuartzControl:managed:), and beta 2 no longer
recognises them afterwards. Coming from the release candidate, nothing changes here.

What changed since 1.0.0-rc.1

Styles

  • Variables: one value field for a variable that holds no colour, instead of a light and a dark
    one. Every theme and build variable can be browsed without searching first. Colour swatches are
    painted over the site's ground, not the app's, and say which ground that is. An emptied field
    stays empty and writes no empty declaration. Typing on the page is noticeably lighter.
  • Custom CSS: the component picker lists each component once and inserts the selector the site
    really renders — ul.tags, not the plugin's name. A class the app has not verified is marked as
    such.
  • Unused fonts: before a font file is deleted, quartz/components/styles and quartz/static
    are searched too.

Templates and the project image

  • The mark at the top left of every template is the project image — icon.png, and
    icon-dark.png in dark mode. Replacing the image under Configuration → Project image replaces
    mark and favicon in one go. The card recognises such a mark, says when the dark image was not
    chosen in the app, and can replace a dark image without a light one being chosen first.
  • The new-project wizard counts the sample pages instead of claiming twenty, and no longer
    claims two languages for every package.
  • The import preview names an icon.png that nobody chose in the app before it is replaced.
  • The documentation templates navigate with quartz-navigations like the others.

Everywhere

  • Taking an entry out of a list is a bin icon everywhere, named after the entry in its tooltip
    — snapshots, stylesheet files, presets, connections, targets, frames, fonts. Deleting a preset
    now asks first, like everything else.
  • Git sync: the card takes the full width. Publish: the note about the base URL appears only
    once the configuration is read, not as a flash on every visit.

macOS Keychain

  • After every update macOS asks whether this version may use the Keychain — usually twice,
    because the app is ad-hoc signed. Answer Always Allow both times.
  • If access is denied, the app says so where a password or token is needed, instead of "no
    token stored", and a restart asks again. The start screen no longer touches the Keychain on
    macOS at all.

The handbook (https://boxi-os.github.io/QuartzControl/) is up to date with this version and has
a new start page; the handbooks of the three plugins got one each, too.

Which file

System File
macOS, Apple Silicon QuartzControl-1.0.0-arm64.dmg — or .zip
macOS, Intel QuartzControl-1.0.0-x64.dmg — or .zip
Linux, x86_64 QuartzControl-1.0.0-x86_64.AppImage or quartzcontrol_1.0.0_amd64.deb
Linux, arm64 QuartzControl-1.0.0-arm64.AppImage or quartzcontrol_1.0.0_arm64.deb
Flatpak QuartzControl-1.0.0-x86_64.flatpak or …-aarch64.flatpak

Linux needs glibc 2.34 or newer for the bundled git — Ubuntu 22.04, Debian 12, RHEL 9,
Fedora 35 and later. On an older system the app starts and says it cannot use its own git; a git
from the package manager gets you going. The Flatpak does not raise the question.

Before the first start

macOS. The app is ad-hoc signed and not notarised; there is no Developer ID certificate, so
macOS refuses the first launch. Allow it under System Settings → Privacy & Security → Security →
"Open Anyway", within about an hour of the refused launch. Or clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/QuartzControl.app

Linux. Make the AppImage executable and run it, or install the deb with
sudo apt install ./quartzcontrol_1.0.0_amd64.deb. For the Flatpak:

flatpak install --user QuartzControl-1.0.0-x86_64.flatpak

--filesystem=home is set, so projects under your home directory work as they are. A content
folder on another drive needs a one-off flatpak override --filesystem=<path>.

What is inside every package

  • Node and npm — Electron's own runtime (Node 24.18.1, npm 11.17.0), exposed as three shims on
    the PATH. Nothing to install.
  • git 2.53.0 — used only when the machine has none that answers; otherwise the system's own wins.
  • The basic template — for creating a project when there is no network.

Known limits

  • Not notarised on macOS, as above. No self-update: the start screen reports a newer
    version and links to it. No Windows, deliberately; the reasons are in the README.
  • Not started on its own kind of machine: the macOS Intel build (there is no Intel Mac here),
    and Linux with a system git older than 2.38. Both are built; neither was run on such a machine.
  • A YAML error in the frontmatter of a single note stops the dev server. That is Quartz; the
    app shows the server as crashed.

Checksums (SHA-256)

7ce1e1e5cce0004a89a04f661e5931fd013a7cd5c8d4892bc100e37e5004d193  QuartzControl-1.0.0-arm64.dmg
72cf61cfb92200314f81baecc42c145dde57a9fb1c0c848bf70a7c0ab4cbb7f5  QuartzControl-1.0.0-arm64.zip
2f4cc59f6d82a7db12cce4b0370b837129c68ed8fb1557179472a23ae8882b8d  QuartzControl-1.0.0-x64.dmg
2fb4e65cca096aa2a506304912724246ce611094197ac22cb8e4c970848f47ba  QuartzControl-1.0.0-x64.zip
f30227ad96d0780c9b9ba8de4c04e08076bc7a79a78e0137293bb87df24e8c08  QuartzControl-1.0.0-arm64.AppImage
63a06a74d244d55544712fb13b5286c4c05bc06e61caeaa95efaa98dc4462f74  QuartzControl-1.0.0-x86_64.AppImage
b6f0d77054508d877aa8c799dbe9383447bbd854b357c01b2438f195f01bf2d1  quartzcontrol_1.0.0_arm64.deb
8aa7a3cbe855b22c81a8c1ffa53e4e8529b5caf8b889360b237a5c2ab3eb3a5c  quartzcontrol_1.0.0_amd64.deb
8b63fb4f2fd1ade57134d21b01bd7a659b0cc4140f85bd22a462c199b25de6bc  QuartzControl-1.0.0-aarch64.flatpak
e8bf620d1dc8f522218cc6051b7de025c6ea1cb64cf02b4e1e7894361c2dacdc  QuartzControl-1.0.0-x86_64.flatpak
Assets 12
Loading