🐞Common Issues

🐞 Common Technical Issues & Fixes

While Obsibrain is designed to be robust, the flexible nature of Obsidian means that occasionally things can go out of sync. Here are the most common issues and how to resolve them quickly.


Error: "t.toJSDate is not a function"

The Cause: This is the most common error users encounter. Because Obsibrain uses custom scripts to render your dashboards, it expects dates to follow a specific format. This error usually triggers when a "broken" date is entered into a metadata field.

The Fix: This error means a script (like projects.js or tasks.js) found a value it couldn't turn into a date. To fix it, you need to identify the note where the incorrect date was entered.

  1. Check the Error Source: Look at the notification (see screenshot below). If it mentions projects.js, the error is likely in one of your Project notes. If it mentions tasks.js, it's in a Task.

  2. Verify the Format: Ensure all dates in your YAML metadata follow the strict YYYY-MM-DD pattern (e.g., 2024-12-25).

  3. Audit Recent Changes: Think about the last few notes you created or edited. Check their "Deadline," "Scheduled," or "Completed" fields for typos or non-standard date text.

Example of the t.toJSDate error indicating an issue in project metadata.

Dashboards are blank or not loading

The Cause: Often caused by a community plugin (like Dataview) being disabled or needing an update.

The Fix:

  1. Check Dependencies: Go to Settings > Community Plugins and ensure Dataview, Templater, and Obsibrain are all toggled ON.

  2. Run Health Check: Restart Obsidian. Our Vault Self-Healing system will run automatically on startup and attempt to restore any broken renderers.

  3. Update: Use the Obsibrain: Check and install updates command to ensure you have the latest script versions.


πŸ”„ The "Magic" Fix: Reload Obsidian

If your dashboards look slightly "off," tasks aren't appearing where they should, or you've just updated a core plugin, the fastest solution is often a simple reload.

The Pro-Tip:

  1. Open the Command Palette (Ctrl/Cmd + P).

  2. Search for and run: "Obsibrain: Reload Obsidian".

What it does: This command triggers a full refresh of the Obsidian window. It re-initializes the Obsibrain "brain," runs the Vault Self-Healing check, and ensures all your Dataview renderers are up-to-date. It's the "turning it off and on again" of the productivity world!

The Fix:

  • Your license key was sent to the email address you used during checkout.

  • Search your inbox for "Obsibrain" or "LemonSqueezy" (our payment processor).

  • If you still can't find it, email us at [email protected]envelope with your order details and we will retrieve it for you.

Last updated