Skip to main content
General settings control the visual appearance, audio experience, and what information is displayed during navigation.

Display

Configure which UI elements are visible while navigating.

Guides

nodesToShow
string
default:"Folders and files"
Control what file types you can interact with during exploration.Options:
  • Folders and files - Navigate and interact with both folders and files
  • Folders only - Only interact with directories
  • Files only - Only interact with individual files
If you’re exploring a large codebase and only want to navigate the directory structure, set this to “Folders only” for a cleaner experience.
minimap
string
default:"Show"
Toggle the overhead minimap view.Options:
  • Show - Display the minimap
  • Hide - Hide the minimap
compass
string
default:"Show"
Toggle compass visibility for orientation.Options:
  • Show - Display the compass
  • Hide - Hide the compass
breadcrumbs
string
default:"Show"
Toggle the breadcrumb navigation trail showing your current path.Options:
  • Show - Display breadcrumbs
  • Hide - Hide breadcrumbs
Press F to toggle the minimap between normal and fullscreen modes while navigating.

Boat Colors

Customize every part of your boat’s appearance with hex color values.
boatColors.walls
string
default:"#222222"
Color of the boat’s walls.
boatColors.roof
string
default:"#c99732"
Color of the flat roof sections on top of the boat.
boatColors.body
string
default:"#ffffff"
Color of the boat’s middle body section.
boatColors.hull
string
default:"#ffffff"
Color of the column tops on the hull.
boatColors.rails
string
default:"#000000"
Color of the side rails along the boat.
boatColors.floaters
string
default:"#eeeeee"
Color of the flotation devices on the sides.
Use your favorite color scheme from your code editor to create a cohesive visual experience.

Audio

Control the volume of ambient sounds and effects.
volume
number
Master volume level for all game audio, including wave sounds.Range: 0.01 to 1.0
  • 0.01 - Quietest setting
  • 1.0 - Maximum volume
The volume setting affects all audio including ambient wave sounds and the boat horn.

Configuration File Reference

All general settings are stored in the settings object:
// src/extension/store/index.ts
export const DEFAULT_SETTINGS = {
  // Display
  minimap: "Show",
  breadcrumbs: "Show",
  compass: "Show",
  nodesToShow: "Folders and files",
  
  // Audio
  volume: 0.5,
  
  // Boat colors
  boatColors: {
    walls: "#222222",
    roof: "#c99732",
    hull: "#ffffff",
    rails: "#000000",
    body: "#ffffff",
    floaters: "#eeeeee",
  },
};

Build docs developers (and LLMs) love