Caution

Ametrine is currently in the pre-alpha state and SHOULD NOT be used in production, it is far from being ready.

Ametrine is a “one of a kind” Zola theme made specifically for personal websites and blogs. It provides good defaults and easy configuration, while being powerful on demand. Its design is unique and made with great care and attention to details, it changes from time to time, and the development pace is rather rapid.

Some of Ametrine’s features:

• Handwritten CSS (Sass); no Tailwind, React, or anything like that.
• No essential JavaScript; pop-ups, sidebars, and such will work just fine without it.
• Relatively lightweight, weights under 512kB.
• Uses modern CSS.
• Includes Monokai Pro theme for syntax highlighting out of the box.
• Will make you regret using this theme.

What Is This Again

This is a theme for the Zola static site generator; thingy that converts Markdown files (which is used by Reddit, Tumblr, Discord, any many others) into a fully functional websites. Zola cannot build websites without a set of templates and styles, and this theme is exactly that. Ametrine also provides some custom functionality that is not present in Zola, such as Mastodon-powered comments, various useful shortcodes for simplifying various tasks, and more.

You can learn more about Zola and its themes at https://www.getzola.org.

Installation

Caution

Ametrine is currently in the pre-alpha state and SHOULD NOT be used in production, it is far from being ready.

If you have Git set up in your project, add Ametrine as a submodule:

git submodule init
git submodule add https://codeberg.org/daudix/ametrine.git themes/ametrine

Important

It is highly recommended to switch from the main branch to the latest release:

cd themes/ametrine
git checkout tags/v0.1.0 # There is currently no tagged release

Then, enable Ametrine in your config.toml:

theme = "ametrine"

To update Ametrine, simply switch to a new tag:

Important

Check the changelog for all versions after the one you are using; there may be breaking changes that require manual involvement.

git submodule update --remote --merge
cd themes/ametrine
git checkout tags/v0.1.0

Why It Looks the Way It Does

Personally, I’m sick of flat, sterile, dead UIs all over the place, and I’ve always liked skeuomorphism because it’s fun, alive, and pleasant to look at. While it’s not very feasible to make things look overly realistic, some edge highlights, nice shadows, and a vibrant palette make a big difference. The design system that Ametrine uses is made of slightly frosted colored acrylic, everything is rounded, but the edges are not so rounded, so the edge highlight is rather thin, you can think of it as Lego bricks, fun and nice to touch. The animations are very bouncy to raise the fun level even higher. Still, the balance between fun and not being annoying is maintained. Did I succeed with this premise? I don’t know, you tell me :P

To-Do

Right now Ametrine is not ready to be used in production and is in active development, here’s a roadmap of features that would be nice have before the initial release: https://codeberg.org/daudix/ametrine/issues/3