devonthesofa_obsidian-note-status/docs/settings.md

## Settings Reference

All settings are grouped the same way you see them in the plugin. Each section lists what it controls and when to tweak it.

---

## Templates & Statuses

### Status templates

- Enable/disable built-in templates or build your own (name, description, ordered statuses with emoji/Lucide + color).
- Auto-enables new templates; you can reset built-ins anytime.
- Good for shared workflows: research pipelines, task boards, project phases.

### Use only custom statuses

- Hides all template statuses so only your standalone statuses appear.
- Handy for very small personal vocabularies (e.g., `idea`, `draft`, `done`).

### Custom statuses

- Create standalone statuses, reorder, delete.
- Useful for special-purpose tags like `needsReviewByJohn` or `instagramPostReady`.

---

## Quick Actions

### Quick Status Commands

- Registers `Set status to ...` commands you can bind to hotkeys.
- Best when you want fast keyboard-driven changes; shines in single-status mode.

---

## Status Bar

### Visibility and behavior

- Show status icon in status bar; optionally hide when no status is set.
- Show status overview popup on hover for a quick per-key breakdown.
- Show template names next to status: never / auto on conflicts (default) / always.

### Badge visuals

- Badge style: accent stripe / filled / dot.
- Badge content: icon + text / icon only / text only / empty accent.

### No-status display

- Custom text for empty state.
- Show icon when no status.
- Show text when no status.

---

## Editor Toolbar

### Toolbar button

- Show/hide the status button in the editor header.
- Position: left / right-before-actions / right.
- Show for: all notes / active note only.

---

## File Explorer

### Icons and placement

- Show status icons in file explorer.
- Icon position: filename left / filename right / absolute right.
- Hide icon when status is unknown.

### Visual treatments (per-option)

- Color filename text.
- Color entire row.
- Left border.
- Status dot.
- Underline filename.

### Icon styling

- Status icon frame: never / always.
- Status icon color: use status colors / inherit theme colors.

---

## Unknown / No-Status Appearance

### Fallback visuals

- Icon for unknown status (emoji or Lucide).
- Color for unknown status (used across status bar/explorer fallbacks).

---

## Behavior & Storage

### Status model

- Enable multiple statuses (default) or force single-status mode.
- Single-status format when multiple is off: list (`status: [draft]`) or string (`status: draft`).

### Write targets

- Apply status recursively to subfolders (folder context menu option).
- Status tag prefix (frontmatter key, default `obsidian-note-status`).
- Frontmatter mappings: map templates or statuses to additional YAML keys; optional “write mapped tags to default” to keep both in sync.
- Strict status validation: removes unknown statuses on edit (use in controlled vocabularies).

### Safeguards

- Vault size limit: disables dashboard and grouped view beyond the threshold.

---

## Experimental Features

### Toggles

- Enable experimental features (master gate).
- Enable status dashboard.
- Enable grouped status view.
- Dashboard/grouped view respect the vault size limit.