Grimoire

Grimoire is a book of tools for Final Fantasy XIV. Each utility is a “page” hosted by a single Electron shell, so position tracking, macro authoring, and whatever comes next live in one app and share settings and data.

It merged two earlier projects that had grown separately. The Live Map page came from ffxiv-live-map, a daemon plus a Leaflet UI that tracks positions in real time. The Macro Studio page came from vscode-ffxiv-macros, a VS Code extension for writing game macros. The extension still exists under its original name, but it now consumes the same core as the desktop app.

That core is the point of the monorepo. macro-lang is a framework-agnostic package that parses, lints, and formats macros and carries the command and placeholder data, with no editor dependency, so it powers both the Monaco-based desktop editor and the VS Code extension. ffxiv-data builds and caches game data from Teamcraft and XIVAPI v2 and feeds both the map and the macro name index. Tests run at three layers, unit and integration with Vitest and end-to-end with Playwright, all green in CI. The desktop app itself is private for now; the two predecessor repos are public.