Troubleshooting

If something isn’t working as it should, you might find this information helpful when debugging or raising issues on GitHub.

Logging

Astro Editor writes a rolling log to your system’s standard logs location:

Platform	Path
macOS	~/Library/Logs/is.danny.astroeditor/Astro Editor.log
Windows	%LOCALAPPDATA%\is.danny.astroeditor\logs\Astro Editor.log
Linux	~/.local/share/is.danny.astroeditor/logs/Astro Editor.log

On macOS you can watch logs as they happen, which is useful for reproducing a specific problem:

1. Open Console.app (Applications → Utilities → Console).
2. Type Astro Editor into the search bar.
3. Reproduce the issue — for example, try opening the project again.
4. Select the relevant rows and copy them.

Most log lines are tagged with a category, which you can search for to narrow things down:

Tag	Covers
[PROJECT_SETUP]	Opening a project and setting it up
[PROJECT_SCAN]	Discovering collections and files
[PROJECT_REGISTRY]	Remembering and migrating projects
[PROJECT_DISCOVERY]	Detecting project metadata
[SCHEMA_MERGER] / [JSON_SCHEMA]	Building frontmatter schemas
[JS_ERROR] / [PROMISE_REJECTION]	Frontend crashes