Why I'm Building Amethyst: A Local-First Markdown App for People Who Just Want to Write ✍️

abdallah mohammad — Sun, 03 May 2026 18:27:05 +0000

Let’s be honest: the world of note-taking is currently split between "too simple" and "way too complex." I found myself constantly switching between tools that were either missing core features or so bloated that they felt like they owned my data.

So, I started building Amethyst. It’s an open-source (AGPL-3.0) Markdown application designed to be simple, fast, and entirely local.

The Concept: What is a "Facet"? 📂

In Amethyst, we use a concept called a Facet. You can think of a Facet exactly like a Vault.

It’s a local directory on your computer that the app "watches" in real-time[cite: 1]. While the current version focuses on a streamlined single-workspace experience, the architecture is designed to support multiple Facets in the future, allowing you to jump between different projects or knowledge bases effortlessly.

What’s Under the Hood? 🛠️

According to the README.md, I wanted an "architecture-first" approach[cite: 1]. This means the app isn't just a basic text editor; it's a robust system built on:

Electron, React, and Vite: For a smooth, cross-platform desktop experience.
CodeMirror 6: A powerful editor foundation that feels snappy and responsive.
A Real-Time Watcher: Using Chokidar to ensure that if you change a file in your folder, Amethyst sees it instantly.

Features That Actually Help You Work 🚀

Based on the latest updates in the CHANGELOG.md, here is what you can do in version 0.5.0:

Keyboard-First Navigation: A centralized shortcut manager so you can create notes (Ctrl+N) or jump between folders without leaving the home row.
Tree View with Drag & Drop: Organise your hierarchy intuitively by moving notes and notebooks exactly where you want them.
LaTeX Math Support: For the engineers and students out there, you can write and preview complex mathematical equations natively.
Context Menus & Toasts: Right-click support for quick actions and a global notification system that gives you instant feedback on every save or move.

See it in Action:

Where We’re Going (The Roadmap) 📍

I’m working toward a stable 1.0.0 release. Here’s a peek at what’s landing soon:

v0.6.0: Safe deletion with .trash logic and debounced autosave.
v0.7.0: The "Command Palette" (Ctrl+Shift+P) and "Quick Open" (Ctrl+P).
v1.0.0: Native PDF/HTML export and a complete keyboard cheat-sheet.

🤝 Open Source & Community

Amethyst is and will always be open-source. I’m looking for active users and contributors to help shape the direction of the "Facet" system.

Check out the repo here: https://github.com/abdallah-moh1/amethyst

If you’re a developer who loves clean architecture and Markdown, I’d love to hear your thoughts.

What is the one thing your current note-taking app does that drives you crazy? Let's talk in the comments!