Build Faster with Estrela Editor: Workflows, Plugins, and Shortcuts

Troubleshooting Estrela Editor: Fix Common Issues Quickly

1. Editor won’t launch

  • Check permissions: Ensure the app has read/write permissions for its installation and config directories.
  • Restart & update: Restart your machine, then update Estrela Editor to the latest version.
  • Run from terminal: Launch from a terminal/console to capture error messages:

    bash

    estrela-editor

    Use the printed error to guide next steps.

2. Crashes or freezes

  • Disable extensions/plugins: Start with extensions/plugins disabled (safe mode) to isolate a faulty plugin.
  • Increase memory limits: If large files cause crashes, raise memory or file-size limits in settings or launch flags.
  • Check logs: Locate the editor log file (usually in ~/.local/share/estrela or %APPDATA%\Estrela) and search for stack traces or fatal errors.

3. Slow performance or high CPU

  • Profile extensions: Temporarily disable nonessential extensions; re-enable one-by-one to find the culprit.
  • Enable hardware acceleration: Toggle GPU/hardware acceleration in settings if available.
  • Reduce file watchers: Exclude large folders from real-time file watching (workspace settings).

4. Plugins/extensions not working

  • Compatibility: Verify plugin compatibility with your Estrela Editor version.
  • Reinstall plugin: Remove and reinstall the plugin, then restart the editor.
  • Check extension host logs: Inspect extension host output (View → Output → Extension Host) for errors.

5. Auto-save, undo, or state issues

  • Verify settings: Confirm auto-save and undo levels in Preferences → Files/Editor.
  • Corrupt workspace storage: Close the editor, back up then clear workspace storage/cache folders, and reopen.
  • Recover unsaved files: Check temp or recovery folders (editor-specific path) for autosave snapshots.

6. Search, indexing, or linting errors

  • Rebuild index: Use the “Rebuild search/index” command if available.
  • Configure linters: Ensure linter executables are installed and paths set in settings.
  • Exclude node_modules/build: Add large generated folders to search/analysis exclusions.

7. Git integration problems

  • Check Git path: Ensure Git is installed and path configured (Preferences → Git).
  • Credential issues: Clear stored credentials or reauthenticate with your provider.
  • Repository state: Run git status in the repo to spot locks, merges, or rebase conflicts.

8. Display, font, or theme glitches

  • Reset UI layout: Use “Reset View” or delete workspace UI state files.
  • Check font config: Verify chosen font is installed; fallback fonts may cause rendering issues.
  • Toggle high-DPI scaling: Adjust scaling settings on high-resolution displays.

9. Terminal/Integrated shell problems

  • Shell path & args: Confirm shell executable and arguments in terminal settings.
  • Environment variables: Ensure PATH and other env vars are loaded; enable “inherit shell environment” if present.
  • PTY errors: Try alternative terminal renderer or disable terminal GPU acceleration.

10. If all else fails — clean reinstall

  1. Export settings and list of extensions.
  2. Uninstall Estrela Editor and remove config, cache, and workspace folders.
  3. Reinstall latest release and import settings/extensions one at a time.

Quick checklist (copyable)

  • Update editor & extensions
  • Disable extensions (safe mode)
  • Inspect logs and terminal output
  • Increase memory / rebuild indexes
  • Clear workspace storage/cache
  • Verify external tools (Git, linters) paths