Skip to content

Configuration

tauri.conf.json

The main Tauri configuration file. Key sections:

App metadata

{
  "productName": "My App",
  "version": "0.1.0",
  "identifier": "com.myorg.myapp"
}

Window settings

{
  "app": {
    "windows": [{
      "title": "My App",
      "width": 1100,
      "height": 700,
      "minWidth": 800,
      "minHeight": 500,
      "decorations": false
    }]
  }
}

Set "decorations": true to use the native OS title bar instead of the custom one.

Updater

{
  "plugins": {
    "updater": {
      "endpoints": [
        "https://github.com/ORG/REPO/releases/latest/download/latest.json"
      ],
      "pubkey": "dW50cnVzdGVkIGNvbW1lbnQ..."
    }
  }
}

See the Auto-Updates guide for key generation.

Bundle

{
  "bundle": {
    "active": true,
    "targets": "all",
    "createUpdaterArtifacts": false
  }
}

"targets": "all" builds all installer formats for the current platform.

Updater artifacts are disabled in the scaffold. Set createUpdaterArtifacts to true after configuring signed updates; see the Auto-Updates guide.


Template tokens

During project generation, Crabyard replaces these tokens across all files:

Token Description Example
{{APP_NAME}} Display name My Desktop App
{{APP_SLUG}} Kebab-case slug my-desktop-app
{{APP_SLUG_SNAKE}} Snake_case slug my_desktop_app
{{APP_BUNDLE_ID}} Bundle identifier com.myorg.my-desktop-app
{{APP_VERSION}} Initial version 0.1.0
{{APP_DESCRIPTION}} Short description A desktop utility
{{APP_AUTHOR}} Author name Jane Doe
{{GENERATED_AT}} Generation timestamp, in Unix seconds 1700000000
{{CRABYARD_VERSION}} CLI version used 1.0.0
{{AUTH_MODULE}} Selected auth module github
{{UI_MODULE}} Selected UI framework shadcn

Capabilities (permissions)

Tauri v2 uses a capability-based permission system. The default capability file at src-tauri/capabilities/default.json grants:

Permission Purpose
core:default Basic Tauri APIs
opener:default Open URLs in the default browser
dialog:default Native file/folder dialogs
store:default Persistent key-value storage
updater:default Check and install app updates
process:default Relaunch the app after update

Add or remove permissions as needed for your app. See the Tauri permissions docs for the full list.