Struct AppState 

pub struct AppState {
    pub theme: Option<String>,
    pub last_dir: Option<PathBuf>,
    pub last_dir_right: Option<PathBuf>,
    pub sort_mode: Option<SortMode>,
    pub show_hidden: Option<bool>,
    pub single_pane: Option<bool>,
    pub cd_on_exit: Option<bool>,
    pub editor: Option<String>,
}

All application state that is persisted between sessions.

Every field is an Option so that absent keys are handled gracefully — the caller provides a sensible default for any field that is None.

Example

use crate::persistence::{AppState, load_state, save_state};
use tui_file_explorer::SortMode;

let mut state = load_state();
state.theme      = Some("nord".into());
state.sort_mode  = Some(SortMode::SizeDesc);
state.show_hidden = Some(true);
save_state(&state);

Fields

theme: Option<String>

Colour theme name (e.g. "grape", "nord", "catppuccin-mocha").

last_dir: Option<PathBuf>

Directory that was open in the left pane when the app last exited.

Only restored when the path still exists as a directory; stale entries (deleted directories) are silently ignored.

last_dir_right: Option<PathBuf>

Directory that was open in the right pane when the app last exited.

Only restored when the path still exists as a directory; stale entries (deleted directories) are silently ignored.

sort_mode: Option<SortMode>

Active sort mode: Name, SizeDesc, or Extension.

show_hidden: Option<bool>

Whether hidden (dot-prefixed) files were visible.

single_pane: Option<bool>

Whether single-pane mode was active.

cd_on_exit: Option<bool>

Whether the cd-on-exit feature is enabled.

When true, tfe prints the active pane’s current directory to stdout on dismiss so the shell wrapper can cd to it. When false (default), dismissing without a selection prints nothing and exits with code 1.

editor: Option<String>

The editor to use when the user presses e on a file.

Serialised as a short key string (e.g. "helix", "nvim", "custom:code"). None means “use the compiled-in default” (Helix).

Trait Implementations

impl Clone for AppState

fn clone(&self) -> AppState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AppState

fn default() -> AppState

Returns the “default value” for a type.

impl PartialEq for AppState

fn eq(&self, other: &AppState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for AppState

impl StructuralPartialEq for AppState