Troubleshooting

Solutions to common issues

App Won't Launch

Check System Requirements

Ensure you're running macOS 14 Sonoma or later on an Apple Silicon Mac. Intel Macs are not supported.

Check Gatekeeper

If you downloaded from outside the App Store, you may need to allow the app in System Settings → Privacy & Security. Right-click the app and select "Open" to bypass Gatekeeper.

Check Console

Open Console.app and look for error messages when launching tibok. This can help identify permission or compatibility issues.

Files Not Saving

Check File Permissions

Make sure tibok has permission to access the folder where you're trying to save. Check System Settings → Privacy & Security → Files and Folders.

Check Disk Space

Ensure you have enough free disk space. Files won't save if your disk is full.

Manual Save

While tibok auto-saves, you can force a save using the standard save shortcut or File menu. Check the status bar to see if the file is saved.

Preview Not Updating

Toggle Preview

Try toggling the preview pane via the command palette or View menu. This can refresh the preview rendering.

Check for Syntax Errors

Some markdown syntax errors can prevent the preview from rendering. Check for unclosed brackets, quotes, or code blocks.

Restart the App

If the preview is stuck, try quitting and restarting tibok. Your work is auto-saved, so you won't lose anything.

Git Issues

Git Not Found

Install Git via Xcode Command Line Tools: xcode-select --install

Authentication Failed

For GitHub, use a Personal Access Token instead of your password. Generate one in GitHub Settings → Developer settings → Personal access tokens.

Push/Pull Fails

Check your internet connection and verify the remote URL is correct. You can check the remote URL in the command palette with "Git: Show Remote".

Performance Issues

Large Files

Very large markdown files (10MB+) may cause performance issues. Consider splitting large documents into multiple files.

Too Many Open Files

Having many files open simultaneously can slow down the app. Close unused files to improve performance.

Restart the App

If the app feels sluggish, try quitting and restarting. This clears memory and can resolve performance issues.

Still Need Help?

If you're still experiencing issues: