← Back to Docs

Configuration

Customize AsterIDE to fit your workflow perfectly.

Settings Overview

AsterIDE offers extensive customization options through the settings panel. Access settings via:

  • • Menu: Settings
  • • Keyboard: Ctrl + , (Windows/Linux) or Cmd + , (macOS)
  • • Command Palette: Ctrl + Shift + P then type "settings"

Tip: Settings can be saved and will persist between sessions.

Appearance

Themes

Choose from built-in themes or create your own custom themes. (Custom themes coming soon.)

Cherry Blossom LightClean, bright interface
Cherry Blossom DarkEasy on the eyes
Rosé PineElegant purple tones
Rosé Pine MoonDark purple theme
Rosé Pine DawnLight purple theme

Editor

Code Editor

  • • show_line_numbers: Display line numbers in the editor (default: true)
  • • word_wrap: Wrap long lines at window edge (default: true)
  • • font_size: Editor text size in pixels (default: 14.0)
  • • tab_size: Number of spaces per tab (default: 4)
  • • use_spaces: Use spaces instead of tabs (default: true)
  • • show_whitespace: Display whitespace characters (default: false)
  • • vim_mode: Enable Vim keybindings (default: false)
  • • highlight_current_line: Highlight the active line (default: true)
  • • auto_indent: Automatically indent new lines (default: true)
  • • scroll_beyond_last_line: Allow scrolling past document end (default: true)
  • • minimap: Show code overview on right side (default: false)

File Management

  • • auto_save: Automatically save files (default: false)
  • • auto_save_interval: Auto-save interval in seconds (default: 30)
  • • recent_files_limit: Maximum recent files to track (default: 5)
  • • recent_projects_limit: Maximum recent projects to track (default: 5)

Interface

  • • sidebar_visible: Show/hide the file sidebar (default: true)
  • • status_bar_visible: Show/hide the status bar (default: true)
  • • corner_roundness: UI corner radius in pixels (default: 6.0)

Search

Search Configuration

  • • search_ignore_dirs_enabled: Enable directory exclusion (default: true)
  • • search_ignored_dirs: Directories to ignore during search
  • • search_min_chars: Minimum characters for search (default: 2)

Default Ignored Directories:

.git, node_modules, venv, .venv, target, dist, build, .next, .cache, __pycache__, .idea, .vscode

Themes

Theme Configuration

  • • theme_family: Theme family name (default: "CherryBlossom")
  • • theme_variant: Specific theme variant (default: "CherryBlossomDark")

Available Themes:

CherryBlossom:

  • • CherryBlossomLight
  • • CherryBlossomDark

Rosé Pine:

  • • Rosé Pine
  • • Rosé Pine Moon
  • • Rosé Pine Dawn

Custom theme support coming soon

Keyboard Shortcuts

Customize Keybindings

Coming Soon

Custom keybinding support is currently under development. Soon you'll be able to modify existing shortcuts and create your own custom keybindings.

Plugins

Plugin Management

Coming Soon

Plugin support is currently under development. Soon you'll be able to extend AsterIDE functionality with plugins and extensions including language support, themes, linters, formatters, and more.

Configuration Files

For advanced users, AsterIDE stores configuration in JSON files:

~/.asteride/settings.json

Main application settings

Warning: Manual editing of configuration files is recommended for advanced users only. Always backup before making changes.