Themes and Settings

Choosing a theme

Tessamark ships with built-in light and dark themes. You can follow your operating system appearance or select a specific palette.

1. Open Settings → Appearance.
2. Choose an option from the Theme menu: System, Light, Dark, or any installed custom theme.
3. The preview swatches show background, accent, and text colours immediately.

The theme editor (Pro)

Tessamark Pro includes a visual theme editor. You can fine-tune editor background shades, border contrast, typography accents, and code syntax highlights.

Click Customise… under the Theme section in Settings. You can modify token values and save the resulting theme to your user themes directory. On the free tier, importing existing themes and community CSS snippets continues working without restrictions.

Settings reference

This reference covers every configuration section across the applications, taken directly from the frontend settings code.

Appearance

Available on macOS, iOS, Linux, and Android.

• Theme: Picker offering System, Light, Dark, and user themes.
• Customise…: Opens the visual theme editor (Pro).

General

Available on macOS, iOS, Linux, and Android. On macOS and iOS, Settings contains the following sections:

• Section "Editor":
  • Font Size: Slider adjusting editor font scale from 10 pt to 30 pt.
  • When a file changes on disk while you have unsaved edits: Configures external change handling (Merge automatically when changes do not overlap, or Always let me review) (Pro).
  • Warn When Opening Large Documents: Toggle (iOS only) to confirm before loading documents exceeding 1 MB into memory.
• Section "Daily Notes":
  • Folder: Directory path relative to the workspace root where daily notes are created.
  • Template Path: Path relative to workspace root for the Markdown template. Supports {{date}}, {{date_long}}, {{time}}, and {{title}}.
• Section "Citations" (Pro):
  • Bibliography File: Displays selected .bib file path and button to choose a bibliography.
  • Citation Style: Picker offering APA, Chicago (author-date), MLA, IEEE, and Harvard.
• Section "Encryption":
  • Enable Encryption / Disable Encryption: Controls client-side authenticated encryption (Pro). Shows key identifier and recovery code status when active.
• FolderSyncSection (header "Sync"):
  • Sync version history in this folder: Toggle to share version history in .mde/history/ packs.
  • Sync now: Manually triggers folder synchronization pass.
  • Device List: Shows connected devices with Forget action.
• AdvancedSyncSection (header "Git Remote"):
  • Remote URL: Git HTTPS repository address.
  • Username: Remote git username.
  • Personal Access Token: Authentication token stored in system keyring.
  • Save: Saves remote configuration.
  • Test connection: Verifies remote connectivity without pushing.
  • Sync now: Triggers pull and push (push requires Pro).
  • Pull only: Pulls remote commits without pushing (free).
  • Disconnect: Removes remote configuration and token.
• OrphanedHistorySection (header "Version History"):
  • Check for Orphaned History…: Scans for shadow repositories detached by folder moves.
  • Relink…: Points detached history to a selected moved workspace folder.
  • Delete: Removes orphaned history directories.

Pro

Available on macOS, iOS, and Android (as a dedicated tab; Linux handles Pro gating via in-situ banners and licence entry):

• Section "Tessamark Pro": Shows current status (Pro or Free). On App Store / Google Play builds, presents purchasing options, Restore Purchases, and Manage Subscription. On direct website builds, displays a Buy Tessamark Pro link to pricing.
• Section "Already have a licence?":
  • Licence / Expires: Displays active licence ID and expiry date when unlocked.
  • Paste your licence key: Text field to enter an existing key.
  • Activate: Checks the licence signature on your device, then tells the licensing server about this device once. If the server cannot be reached, Pro still switches on and the device is registered later.
  • Remove Licence: Deactivates licence on this device.

AI assistant

Available on macOS, iOS, Linux, and Android (tab "AI Assistant" on desktop/Apple, "AI" on Android):

• Provider: Preset picker with eight presets: Camelid (Local), Ollama (Local), LM Studio (Local), OpenAI, OpenRouter, xAI, Google (Gemini) and Anthropic (via OpenRouter).
• Endpoint URL: URL of the completion service.
• Model Name: Picker or text entry for the model identifier.
• API Key: Secret key for cloud providers (omitted for local models).

Privacy

Available on macOS, iOS, Linux, and Android:

• Section "Telemetry":
  • Enable Crash Reporting: Toggle controlling prompt offers on critical errors.
  • Telemetry Endpoint: Destination server URL for diagnostic error reports.
  • Simulate Crash: Button to verify crash report flow safely.
• Section "Feedback":
  • Feedback Endpoint: Submission endpoint for Send Feedback. Clear this field to disable sending.

Publishing

Available on macOS, iOS, Linux, and Android:

• Section "Publishing Profiles": Manage Ghost blog destinations (Add Profile, edit profile URL, Admin API key, and default publish status).

Platform differences

On Linux, settings are arranged across six sidebar pages: Appearance, General, AI Assistant, Privacy, Publishing, and Sync (combining Folder Sync and Git Remote). Android arranges settings into eight scrollable tabs: Appearance, General, AI, Privacy, Publishing, Sync (git remote only; folder sync is not applicable because vaults are app-private), Pro, and About.