Settings Reference
Comprehensive reference of all configurable settings in Basalt, organized by category. Settings are stored locally in the vault configuration directory (.basalt/config.json) and synchronized automatically.
General
| Key | Type | Default | Description |
|---|---|---|---|
language | string | "en" | Display language code |
autoUpdates | boolean | true | Automatically download stable updates |
earlyAccess | boolean | false | Receive pre-release / canary builds |
Appearance
| Key | Type | Default | Description |
|---|---|---|---|
theme | string | "dark" | Active theme name (dark, light, nord, solarized, etc.) |
themeTransitionShape | string | "circle" | Geometric mask shape during theme switch (circle, diamond, hexagon, etc.) |
accentColor | string | "" (theme default) | Custom hex or HSL accent override |
fontFamily | string | "" (Inter default) | Interface font family override |
fontSize | number | 14 | Base interface font size in pixels |
zoomLevel | number | 100 | Interface zoom percentage |
Editor
| Key | Type | Default | Description |
|---|---|---|---|
defaultViewMode | string | "live-preview" | Initial view mode for new tabs (live-preview or reading) |
readableLineLength | boolean | true | Constrains prose line width for comfortable reading |
strictLineBreaks | boolean | false | Requires two trailing spaces for single line breaks |
showLineNumbers | boolean | true | Displays gutter line numbers in editor |
foldHeading | boolean | true | Allows collapsing sections beneath Markdown headings |
autoPairBrackets | boolean | true | Automatically inserts matching brackets, quotes, and wikilink pairs |
tabSize | string | "2" | Indentation size: "2", "4", or "tab" |
vimMode | boolean | false | Enables modal Vim keybindings in the editor |
Files & Links
| Key | Type | Default | Description |
|---|---|---|---|
defaultNoteLocation | string | "vault-root" | Target directory for new notes (vault-root, same-folder, custom-folder) |
attachmentFolder | string | "_attachments" | Directory where dropped attachments and images are saved |
attachmentOrganization | string | "flat" | Attachment sub-tree layout (flat, by_note, by_date) |
attachmentNaming | string | "{original_name}" | Attachment filename pattern |
renameAttachmentsWithNote | boolean | true | Automatically renames attachments when the host note is renamed |
Tasks
| Key | Type | Default | Description |
|---|---|---|---|
tasks.globalFilter | string | "" | Tag or text required for checklists to be indexed as tasks |
tasks.defaultPriority | string | "none" | Default priority level for new tasks |
tasks.doneDateAutoAdd | boolean | true | Appends ✅ YYYY-MM-DD when marked done |
tasks.cancelledDateAutoAdd | boolean | true | Appends ❌ YYYY-MM-DD when marked cancelled |
tasks.createdDateAutoAdd | boolean | false | Appends ➕ YYYY-MM-DD on task creation |
tasks.statusSequence | array | ["in_progress", "done"] | State cycle order when toggling checkboxes |
tasks.boardColumns | array | ["todo", "in_progress", "on_hold", "done"] | Visible columns in the Task Board |
Calendar & Daily Notes
| Key | Type | Default | Description |
|---|---|---|---|
dailyNotesFolder | string | "Daily" | Directory where daily notes are stored |
dailyNoteDateFormat | string | "YYYY-MM-DD" | Filename pattern for daily notes |
dailyNoteTemplate | string | "" | Path to template file applied to new daily notes |
calendarWeekStart | string | "auto" | Starting day of the week (auto, or 0–6 for Sun–Sat) |
calendarShowWeekNumbers | boolean | true | Display week numbers in the calendar sidebar |
Templates
| Key | Type | Default | Description |
|---|---|---|---|
templateFolder | string | "Templates" | Vault directory where template Markdown notes reside |