299 lines · 9.3 KB · JSON
RawDownload
{  "$comment": "Settings contract: keys, types, defaults, labels, descriptions, and CSS-var bindings. Read by Rust (apps/desktop/src-tauri/src/config.rs) via include_str! and by the frontend via a static import (lib/settings-schema.ts). Theme preset *values* are not part of the contract — they live in shared/themes/*.json, one file per preset. Per docs/consolidation.md: do not declare defaults, labels, or types anywhere else.",  "settings": [    {      "key": "editor.font-size",      "label": "Font Size",      "description": "Font size in pixels for the editor",      "category": "Editor",      "type": "number",      "default": 16,      "cssVar": "--writer-editor-font-size",      "cssFormat": "px"    },    {      "key": "editor.line-height",      "label": "Line Height",      "description": "Line height multiplier for the editor",      "category": "Editor",      "type": "number",      "default": 1.8,      "cssVar": "--writer-editor-line-height"    },    {      "key": "editor.tab-size",      "label": "Tab Size",      "description": "Number of spaces per tab",      "category": "Editor",      "type": "number",      "default": 2    },    {      "key": "appearance.theme",      "label": "Schema",      "description": "Light or dark color schema",      "category": "Appearance",      "type": "enum",      "options": ["system", "light", "dark"],      "default": "system"    },    {      "key": "appearance.sidebar-width",      "label": "Sidebar Width",      "description": "Default sidebar width in pixels",      "category": "Appearance",      "type": "number",      "default": 240    },    {      "key": "appearance.sidebar-visible",      "label": "Sidebar Visible",      "description": "Show the sidebar by default",      "category": "Appearance",      "type": "boolean",      "default": true    },    {      "key": "appearance.sidebar-file-label",      "label": "Sidebar File Label",      "description": "Show the document title or the filename for files in the sidebar",      "category": "Appearance",      "type": "enum",      "options": ["title", "filename"],      "default": "title"    },    {      "key": "appearance.editor-width",      "label": "Editor Width",      "description": "Editor content width mode",      "category": "Appearance",      "type": "enum",      "options": ["full", "narrow"],      "default": "full"    },    {      "key": "theme.light.preset",      "label": "Preset",      "description": "Light theme preset",      "category": "Theme",      "$comment": "Valid values are populated at runtime from shared/themes/*.json plus the special \"custom\" sentinel; we intentionally don't enum-constrain the contract so adding a preset doesn't require a schema edit.",      "type": "string",      "default": "Writer"    },    {      "key": "theme.light.accent",      "label": "Accent",      "description": "Light theme accent color",      "category": "Theme",      "type": "color",      "cssVar": "--accent",      "default": "#FF6A00"    },    {      "key": "theme.light.background",      "label": "Background",      "description": "Light theme background color",      "category": "Theme",      "type": "color",      "cssVar": "--bg-base",      "default": "#FFFFFF"    },    {      "key": "theme.light.foreground",      "label": "Foreground",      "description": "Light theme foreground color",      "category": "Theme",      "type": "color",      "cssVar": "--fg-base",      "default": "#0D0D0D"    },    {      "key": "theme.light.ui-font",      "label": "UI font",      "description": "Light theme UI font stack",      "category": "Theme",      "type": "string",      "cssVar": "--ui-font",      "default": "-apple-system-body, ui-sans-serif, -apple-system, system-ui, \"Segoe UI\", Helvetica, \"Apple Color Emoji\", Arial, sans-serif, \"Segoe UI Emoji\", \"Segoe UI Symbol\""    },    {      "key": "theme.light.editor-font",      "label": "Editor font",      "description": "Light theme editor body font stack",      "category": "Theme",      "type": "string",      "cssVar": "--editor-font",      "default": "-apple-system-body, ui-sans-serif, -apple-system, system-ui, \"Segoe UI\", Helvetica, \"Apple Color Emoji\", Arial, sans-serif, \"Segoe UI Emoji\", \"Segoe UI Symbol\""    },    {      "key": "theme.light.translucent",      "label": "Translucent",      "description": "Light theme translucency (0 = solid, 100 = max).",      "category": "Theme",      "type": "range",      "min": 0,      "max": 100,      "step": 1,      "default": 10    },    {      "key": "theme.light.contrast",      "label": "Contrast",      "description": "alpha multiplier on borders, cards, hover bgs.",      "category": "Theme",      "type": "range",      "min": 0,      "max": 100,      "step": 1,      "default": 20    },    {      "key": "theme.dark.preset",      "label": "Preset",      "description": "Dark theme preset",      "category": "Theme",      "$comment": "Valid values are populated at runtime from shared/themes/*.json plus the special \"custom\" sentinel; we intentionally don't enum-constrain the contract so adding a preset doesn't require a schema edit.",      "type": "string",      "default": "Writer"    },    {      "key": "theme.dark.accent",      "label": "Accent",      "description": "Dark theme accent color",      "category": "Theme",      "type": "color",      "cssVar": "--accent",      "default": "#FF6A00"    },    {      "key": "theme.dark.background",      "label": "Background",      "description": "Dark theme background color",      "category": "Theme",      "type": "color",      "cssVar": "--bg-base",      "default": "#111111"    },    {      "key": "theme.dark.foreground",      "label": "Foreground",      "description": "Dark theme foreground color",      "category": "Theme",      "type": "color",      "cssVar": "--fg-base",      "default": "#FCFCFC"    },    {      "key": "theme.dark.ui-font",      "label": "UI font",      "description": "Dark theme UI font stack",      "category": "Theme",      "type": "string",      "cssVar": "--ui-font",      "default": "-apple-system-body, ui-sans-serif, -apple-system, system-ui, \"Segoe UI\", Helvetica, \"Apple Color Emoji\", Arial, sans-serif, \"Segoe UI Emoji\", \"Segoe UI Symbol\""    },    {      "key": "theme.dark.editor-font",      "label": "Editor font",      "description": "Dark theme editor body font stack",      "category": "Theme",      "type": "string",      "cssVar": "--editor-font",      "default": "-apple-system-body, ui-sans-serif, -apple-system, system-ui, \"Segoe UI\", Helvetica, \"Apple Color Emoji\", Arial, sans-serif, \"Segoe UI Emoji\", \"Segoe UI Symbol\""    },    {      "key": "theme.dark.translucent",      "label": "Translucent",      "description": "Dark theme translucency (0 = solid, 100 = max).",      "category": "Theme",      "type": "range",      "min": 0,      "max": 100,      "step": 1,      "default": 20    },    {      "key": "theme.dark.contrast",      "label": "Contrast",      "description": "alpha multiplier on borders, cards, hover bgs.",      "category": "Theme",      "type": "range",      "min": 0,      "max": 100,      "step": 1,      "default": 16    },    {      "key": "files.associations",      "label": "File Associations",      "description": "File patterns to include in the workspace",      "category": "Files",      "type": "list",      "default": ["*.md", "*.mdx", "*.markdown"]    },    {      "key": "files.default-encoding",      "label": "Default Encoding",      "description": "Default text encoding for files",      "category": "Files",      "type": "string",      "default": "utf-8"    },    {      "key": "files.insert-final-newline",      "label": "Insert Final Newline",      "description": "Ensure files end with a newline when saving",      "category": "Files",      "type": "boolean",      "default": true    },    {      "key": "files.trim-trailing-whitespace",      "label": "Trim Trailing Whitespace",      "description": "Remove trailing whitespace from lines when saving",      "category": "Files",      "type": "boolean",      "default": false    },    {      "key": "workspace.restore-open-files",      "label": "Restore Open Files",      "description": "Reopen previously open files when opening a workspace",      "category": "Workspace",      "type": "boolean",      "default": true    },    {      "key": "workspace.max-recent-workspaces",      "label": "Max Recent Workspaces",      "description": "Maximum number of recent workspaces to remember",      "category": "Workspace",      "type": "number",      "default": 10    },    {      "key": "window.restore-workspace",      "label": "Restore Workspace",      "description": "Automatically reopen the last workspace when the app starts",      "category": "Window",      "type": "boolean",      "default": true    },    {      "key": "search.debounce-ms",      "label": "Search Debounce",      "description": "Delay in milliseconds before performing search",      "category": "Search",      "type": "number",      "default": 150    },    {      "key": "search.max-results",      "label": "Max Search Results",      "description": "Maximum number of search results to return",      "category": "Search",      "type": "number",      "default": 50    }  ]}

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t