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 and switching projects
[PROJECT_SCAN]	Reading the content config and finding collections
[Schema]	Reading collections’ generated schemas
[WATCHER]	Noticing changes to files, the content config and schemas
[PREFERENCES]	Settings files and the project list, including files set aside because they couldn’t be read
[JS_ERROR] / [PROMISE_REJECTION]	Errors in the app’s interface