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 Zola theme made specifically for personal websites and blogs, it provides good defaults and easy configuration, while being powerful on demand. Its design is rather unique and changes from time to time, and the development pace is rather rapid.
Some of Ametrine’s features:
- Handwritten 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
If you have Git set up in your project, add Ametrine as a submodule:
Important
It is highly recommended to switch from the
main
branch to the latest release:
Then, enable Ametrine in your config.toml
:
= "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.
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 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 short roadmap of features that need to be added and things to be done before the initial release:
- Add i18n support
- Organize Sass files
- Simplify and optimize some logic in the templates
- Remove leftover unused code from Duckquill
- Add emoji reactions support to comments (supported by Chuckya, Akkoma/Pleroma, Misskey and its forks)
- Add pinned posts
- Add post series support
- Add some utility classes
- Write good documentation
- Write a migration guide for Duckquill users
- Credit all the stuff that needs to be credited
- Make sure everything looks nice on mobile
- Add mods like in Duckquill
- Add optional Content Security Policy