"description":"The Tauri configuration object. It is read from a file where you can define your frontend assets, configure the bundler, enable the app updater, define a system tray, enable APIs via the allowlist and more.\n\nThe configuration file is generated by the [`tauri init`](https://tauri.app/v1/api/cli#init) command that lives in your Tauri application source directory (src-tauri).\n\nOnce generated, you may modify it at will to customize your Tauri application.\n\n## File Formats\n\nBy default, the configuration is defined as a JSON file named `tauri.conf.json`.\n\nTauri also supports JSON5 and TOML files via the `config-json5` and `config-toml` Cargo features, respectively. The JSON5 file name must be either `tauri.conf.json` or `tauri.conf.json5`. The TOML file name is `Tauri.toml`.\n\n## Platform-Specific Configuration\n\nIn addition to the default configuration file, Tauri can read a platform-specific configuration from `tauri.linux.conf.json`, `tauri.windows.conf.json`, and `tauri.macos.conf.json` (or `Tauri.linux.toml`, `Tauri.windows.toml` and `Tauri.macos.toml` if the `Tauri.toml` format is used), which gets merged with the main configuration object.\n\n## Configuration Structure\n\nThe configuration is composed of the following objects:\n\n- [`package`](#packageconfig): Package settings - [`tauri`](#tauriconfig): The Tauri config - [`build`](#buildconfig): The build configuration - [`plugins`](#pluginconfig): The plugins config\n\n```json title=\"Example tauri.config.json file\" { \"build\": { \"beforeBuildCommand\": \"\", \"beforeDevCommand\": \"\", \"devPath\": \"../dist\", \"distDir\": \"../dist\" }, \"package\": { \"productName\": \"tauri-app\", \"version\": \"0.1.0\" }, \"tauri\": { \"allowlist\": { \"all\": true }, \"bundle\": {}, \"security\": { \"csp\": null }, \"updater\": { \"active\": false }, \"windows\": [ { \"fullscreen\": false, \"height\": 600, \"resizable\": true, \"title\": \"Tauri App\", \"width\": 800 } ] } } ```",
"type":"object",
"properties":{
"$schema":{
"description":"The JSON schema for the Tauri config.",
"description":"App version. It is a semver version number or a path to a `package.json` file containing the `version` field. If removed the version number from `Cargo.toml` is used.",
"description":"Whether the file drop is enabled or not on the webview. By default it is enabled.\n\nDisabling it is required to use drag and drop on the frontend on Windows.",
"default":true,
"type":"boolean"
},
"center":{
"description":"Whether or not the window starts centered or not.",
"default":false,
"type":"boolean"
},
"x":{
"description":"The horizontal position of the window's top left corner",
"description":"Whether the window is resizable or not. When resizable is set to false, native window's maximize button is automatically disabled.",
"default":true,
"type":"boolean"
},
"maximizable":{
"description":"Whether the window's native maximize button is enabled or not. If resizable is set to false, this setting is ignored.\n\n## Platform-specific\n\n- **macOS:** Disables the \"zoom\" button in the window titlebar, which is also used to enter fullscreen mode. - **Linux / iOS / Android:** Unsupported.",
"default":true,
"type":"boolean"
},
"minimizable":{
"description":"Whether the window's native minimize button is enabled or not.\n\n## Platform-specific\n\n- **Linux / iOS / Android:** Unsupported.",
"default":true,
"type":"boolean"
},
"closable":{
"description":"Whether the window's native close button is enabled or not.\n\n## Platform-specific\n\n- **Linux:** \"GTK+ will do its best to convince the window manager not to show a close button. Depending on the system, this function may not have any effect when called on a window that is already visible\" - **iOS / Android:** Unsupported.",
"description":"Whether the window starts as fullscreen or not.",
"default":false,
"type":"boolean"
},
"focus":{
"description":"Whether the window will be initially focused or not.",
"default":true,
"type":"boolean"
},
"transparent":{
"description":"Whether the window is transparent or not.\n\nNote that on `macOS` this requires the `macos-private-api` feature flag, enabled under `tauri > macOSPrivateApi`. WARNING: Using private APIs on `macOS` prevents your application from being accepted to the `App Store`.",
"default":false,
"type":"boolean"
},
"maximized":{
"description":"Whether the window is maximized or not.",
"default":false,
"type":"boolean"
},
"visible":{
"description":"Whether the window is visible or not.",
"default":true,
"type":"boolean"
},
"decorations":{
"description":"Whether the window should have borders and bars.",
"default":true,
"type":"boolean"
},
"alwaysOnTop":{
"description":"Whether the window should always be on top of other windows.",
"description":"Defines the window [tabbing identifier] for macOS.\n\nWindows with matching tabbing identifiers will be grouped together. If the tabbing identifier is not set, automatic tabbing will be disabled.\n\n[tabbing identifier]: <https://developer.apple.com/documentation/appkit/nswindow/1644704-tabbingidentifier>",
"description":"Defines additional browser arguments on Windows. By default wry passes `--disable-features=msWebOOUI,msPdfOOUI,msSmartScreenProtection` so if you use this method, you also need to disable these components by yourself if you want.",
"description":"An URL to open on a Tauri webview window.",
"anyOf":[
{
"description":"An external URL.",
"type":"string",
"format":"uri"
},
{
"description":"The path portion of an app URL. For instance, to load `tauri://localhost/users/john`, you can simply provide `users/john` in this configuration.",
"description":"Makes the title bar transparent, so the window background color is shown instead.\n\nUseful if you don't need to have actual HTML under the title bar. This lets you avoid the caveats of using `TitleBarStyle::Overlay`. Will be more useful when Tauri lets you set a custom window background color.",
"type":"string",
"enum":[
"Transparent"
]
},
{
"description":"Shows the title bar as a transparent overlay over the window's content.\n\nKeep in mind: - The height of the title bar is different on different OS versions, which can lead to window the controls and title not being where you don't expect. - You need to define a custom drag region to make your window draggable, however due to a limitation you can't drag the window when it's not in focus <https://github.com/tauri-apps/tauri/issues/4316>. - The color of the window title depends on the system theme.",
"description":"Adds additional help information to be displayed in addition to auto-generated help. This information is displayed before the auto-generated help information. This is often used for header information.",
"description":"Adds additional help information to be displayed in addition to auto-generated help. This information is displayed after the auto-generated help information. This is often used to describe how to use the arguments, or caveats to be noted.",
"description":"The short version of the argument, without the preceding -.\n\nNOTE: Any leading `-` characters will be stripped, and only the first non-character will be used as the short version.",
"description":"The argument long description which will be shown on the help information. Typically this a more detailed (multi-line) message that describes the argument.",
"description":"Specifies that the argument takes a value at run time.\n\nNOTE: values for arguments may be specified in any of the following methods - Using a space such as -o value or --option value - Using an equals and no space such as -o=value or --option=value - Use a short and no space such as -ovalue",
"default":false,
"type":"boolean"
},
"multiple":{
"description":"Specifies that the argument may have an unknown number of multiple values. Without any other settings, this argument may appear only once.\n\nFor example, --opt val1 val2 is allowed, but --opt val1 val2 --opt val3 is not.\n\nNOTE: Setting this requires `takes_value` to be set to true.",
"default":false,
"type":"boolean"
},
"multipleOccurrences":{
"description":"Specifies that the argument may appear more than once. For flags, this results in the number of occurrences of the flag being recorded. For example -ddd or -d -d -d would count as three occurrences. For options or arguments that take a value, this does not affect how many values they can accept. (i.e. only one at a time is allowed)\n\nFor example, --opt val1 --opt val2 is allowed, but --opt val1 val2 is not.",
"default":false,
"type":"boolean"
},
"numberOfValues":{
"description":"Specifies how many values are required to satisfy this argument. For example, if you had a `-f <file>` argument where you wanted exactly 3 'files' you would set `number_of_values = 3`, and this argument wouldn't be satisfied unless the user provided 3 and only 3 values.\n\n**NOTE:** Does *not* require `multiple_occurrences = true` to be set. Setting `multiple_occurrences = true` would allow `-f <file> <file> <file> -f <file> <file> <file>` where as *not* setting it would only allow one occurrence of this argument.\n\n**NOTE:** implicitly sets `takes_value = true` and `multiple_values = true`.",
"description":"Specifies a list of possible values for this argument. At runtime, the CLI verifies that only one of the specified values was used, or fails with an error message.",
"description":"Specifies the minimum number of values for this argument. For example, if you had a -f `<file>` argument where you wanted at least 2 'files', you would set `minValues: 2`, and this argument would be satisfied if the user provided, 2 or more values.",
"description":"Specifies the maximum number of values are for this argument. For example, if you had a -f `<file>` argument where you wanted up to 3 'files', you would set .max_values(3), and this argument would be satisfied if the user provided, 1, 2, or 3 values.",
"description":"Sets whether or not the argument is required by default.\n\n- Required by default means it is required, when no other conflicting rules have been evaluated - Conflicting rules take precedence over being required.",
"default":false,
"type":"boolean"
},
"requiredUnlessPresent":{
"description":"Sets an arg that override this arg's required setting i.e. this arg will be required unless this other argument is present.",
"description":"Sets args that override this arg's required setting i.e. this arg will be required unless at least one of these other arguments are present.",
"description":"Tets an argument by name that is required when this one is present i.e. when using this argument, the following argument must be present.",
"description":"Sts multiple arguments by names that are required when this one is present i.e. when using this argument, the following arguments must be present.",
"description":"Allows a conditional requirement with the signature [arg, value] the requirement will only become valid if `arg`'s value equals `${value}`.",
"description":"Allows specifying that an argument is required conditionally with the signature [arg, value] the requirement will only become valid if the `arg`'s value equals `${value}`.",
"description":"The positional argument index, starting at 1.\n\nThe index refers to position according to other positional argument. It does not define position in the argument list as a whole. When utilized with multiple=true, only the last positional argument may be defined as multiple (i.e. the one with the highest index).",
"description":"The application identifier in reverse domain name notation (e.g. `com.tauri.example`). This string must be unique across applications since it is used in system configurations like the bundle ID and path to the webview data directory. This string must contain only alphanumeric characters (A–Z, a–z, and 0–9), hyphens (-), and periods (.).",
"type":"string"
},
"publisher":{
"description":"The application's publisher. Defaults to the second element in the identifier string. Currently maps to the Manufacturer property of the Windows Installer.",
"description":"Configuration for the AppImage bundle.",
"default":{
"bundleMediaFramework":false
},
"allOf":[
{
"$ref":"#/definitions/AppImageConfig"
}
]
},
"deb":{
"description":"Configuration for the Debian bundle.",
"default":{
"files":{}
},
"allOf":[
{
"$ref":"#/definitions/DebConfig"
}
]
},
"macOS":{
"description":"Configuration for the macOS bundles.",
"default":{
"minimumSystemVersion":"10.13"
},
"allOf":[
{
"$ref":"#/definitions/MacConfig"
}
]
},
"externalBin":{
"description":"A list of—either absolute or relative—paths to binaries to embed with your application.\n\nNote that Tauri will look for system-specific binaries following the pattern \"binary-name{-target-triple}{.system-extension}\".\n\nE.g. for the external binary \"my-binary\", Tauri looks for:\n\n- \"my-binary-x86_64-pc-windows-msvc.exe\" for Windows - \"my-binary-x86_64-apple-darwin\" for macOS - \"my-binary-x86_64-unknown-linux-gnu\" for Linux\n\nso don't forget to provide binaries for all targeted platforms.",
"description":"Include additional gstreamer dependencies needed for audio and video playback. This increases the bundle size by ~15-35MB depending on your build system.",
"description":"A list of strings indicating any macOS X frameworks that need to be bundled with the application.\n\nIf a name is used, \".framework\" must be omitted and it will look for standard install locations. You may also use a path to a specific framework.",
"description":"A version string indicating the minimum macOS X version that the bundled application supports. Defaults to `10.13`.\n\nSetting it to `null` completely removes the `LSMinimumSystemVersion` field on the bundle's `Info.plist` and the `MACOSX_DEPLOYMENT_TARGET` environment variable.\n\nAn empty string is considered an invalid value so the default value is used.",
"description":"Whether to use Time-Stamp Protocol (TSP, a.k.a. RFC 3161) for the timestamp server. Your code signing provider may use a TSP timestamp server, like e.g. SSL.com does. If so, enable TSP by setting to true.",
"default":false,
"type":"boolean"
},
"webviewInstallMode":{
"description":"The installation mode for the Webview2 runtime.",
"default":{
"silent":true,
"type":"downloadBootstrapper"
},
"allOf":[
{
"$ref":"#/definitions/WebviewInstallMode"
}
]
},
"webviewFixedRuntimePath":{
"description":"Path to the webview fixed runtime to use. Overwrites [`Self::webview_install_mode`] if set.\n\nWill be removed in v2, prefer the [`Self::webview_install_mode`] option.\n\nThe fixed version can be downloaded [on the official website](https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section). The `.cab` file must be extracted to a folder and this folder path must be defined on this field.",
"description":"Validates a second app installation, blocking the user from installing an older version if set to `false`.\n\nFor instance, if `1.2.1` is installed, the user won't be able to install app version `1.2.0` or `1.1.5`.\n\nThe default value of this flag is `true`.",
"default":true,
"type":"boolean"
},
"wix":{
"description":"Configuration for the MSI generated with WiX.",
"description":"Install modes for the Webview2 runtime. Note that for the updater bundle [`Self::DownloadBootstrapper`] is used.\n\nFor more information see <https://tauri.app/v1/guides/building/windows>.",
"oneOf":[
{
"description":"Do not install the Webview2 as part of the Windows Installer.",
"description":"Download the bootstrapper and run it. Requires an internet connection. Results in a smaller installer size, but is not recommended on Windows 7.",
"description":"Embed the bootstrapper and run it. Requires an internet connection. Increases the installer size by around 1.8MB, but offers better support on Windows 7.",
"description":"The path to the fixed runtime to use.\n\nThe fixed version can be downloaded [on the official website](https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section). The `.cab` file must be extracted to a folder and this folder path must be defined on this field.",
"description":"The installer languages to build. See <https://docs.microsoft.com/en-us/windows/win32/msi/localizing-the-error-and-actiontext-tables>.",
"description":"A list of paths to .wxs files with WiX fragments to use.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"componentGroupRefs":{
"description":"The ComponentGroup element ids you want to reference from the fragments.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"componentRefs":{
"description":"The Component element ids you want to reference from the fragments.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"featureGroupRefs":{
"description":"The FeatureGroup element ids you want to reference from the fragments.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"featureRefs":{
"description":"The Feature element ids you want to reference from the fragments.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"mergeRefs":{
"description":"The Merge element ids you want to reference from the fragments.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"skipWebviewInstall":{
"description":"Disables the Webview2 runtime installation after app install.\n\nWill be removed in v2, prefer the [`WindowsConfig::webview_install_mode`] option.",
"default":false,
"type":"boolean"
},
"license":{
"description":"The path to the license file to render on the installer.\n\nMust be an RTF file, so if a different extension is provided, we convert it to the RTF format.",
"description":"Create an elevated update task within Windows Task Scheduler.",
"default":false,
"type":"boolean"
},
"bannerPath":{
"description":"Path to a bitmap file to use as the installation user interface banner. This bitmap will appear at the top of all but the first page of the installer.\n\nThe required dimensions are 493px × 58px.",
"description":"Path to a bitmap file to use on the installation user interface dialogs. It is used on the welcome and completion dialogs. The required dimensions are 493px × 312px.",
"description":"The path to a locale (`.wxl`) file. See <https://wixtoolset.org/documentation/manual/v3/howtos/ui_and_localization/build_a_localized_version.html>.",
"description":"A list of installer languages. By default the OS language is used. If the OS language is not in the list of languages, the first language will be used. To allow the user to select the language, set `display_language_selector` to `true`.\n\nSee <https://github.com/kichik/nsis/tree/9465c08046f00ccb6eda985abbdbf52c275c6c4d/Contrib/Language%20files> for the complete list of languages.",
"description":"A key-value pair where the key is the language and the value is the path to a custom `.nsh` file that holds the translated text for tauri's custom messages.\n\nSee <https://github.com/tauri-apps/tauri/blob/dev/tooling/bundler/src/bundle/windows/templates/nsis-languages/English.nsh> for an example `.nsh` file.\n\n**Note**: the key must be a valid NSIS language and it must be added to [`NsisConfig`] languages array,",
"description":"Whether to display a language selector dialog before the installer and uninstaller windows are rendered or not. By default the OS language is selected, with a fallback to the first language in the `languages` array.",
"description":"Default mode for the installer.\n\nInstall the app by default in a directory that doesn't require Administrator access.\n\nInstaller metadata will be saved under the `HKCU` registry path.",
"type":"string",
"enum":[
"currentUser"
]
},
{
"description":"Install the app by default in the `Program Files` folder directory requires Administrator access for the installation.\n\nInstaller metadata will be saved under the `HKLM` registry path.",
"type":"string",
"enum":[
"perMachine"
]
},
{
"description":"Combines both modes and allows the user to choose at install time whether to install for the current user or per machine. Note that this mode will require Administrator access even if the user wants to install it for the current user only.\n\nInstaller metadata will be saved under the `HKLM` or `HKCU` registry path based on the user's choice.",
"description":"Compression algorithms used in the NSIS installer.\n\nSee <https://nsis.sourceforge.io/Reference/SetCompressor>",
"oneOf":[
{
"description":"ZLIB uses the deflate algorithm, it is a quick and simple method. With the default compression level it uses about 300 KB of memory.",
"type":"string",
"enum":[
"zlib"
]
},
{
"description":"BZIP2 usually gives better compression ratios than ZLIB, but it is a bit slower and uses more memory. With the default compression level it uses about 4 MB of memory.",
"type":"string",
"enum":[
"bzip2"
]
},
{
"description":"LZMA (default) is a new compression method that gives very good compression ratios. The decompression speed is high (10-20 MB/s on a 2 GHz CPU), the compression speed is lower. The memory size that will be used for decompression is the dictionary size plus a few KBs, the default is 8 MB.",
"description":"Allowlist configuration. The allowlist is a translation of the [Cargo allowlist features](https://docs.rs/tauri/latest/tauri/#cargo-allowlist-features).\n\n# Notes\n\n- Endpoints that don't have their own allowlist option are enabled by default. - There is only \"opt-in\", no \"opt-out\". Setting an option to `false` has no effect.\n\n# Examples\n\n- * [`\"app-all\": true`](https://tauri.app/v1/api/config/#appallowlistconfig.all) will make the [hide](https://tauri.app/v1/api/js/app#hide) endpoint be available regardless of whether `hide` is set to `false` or `true` in the allowlist.",
"description":"The access scope for the filesystem APIs.",
"default":[],
"allOf":[
{
"$ref":"#/definitions/FsAllowlistScope"
}
]
},
"all":{
"description":"Use this flag to enable all file system API features.",
"default":false,
"type":"boolean"
},
"readFile":{
"description":"Read file from local filesystem.",
"default":false,
"type":"boolean"
},
"writeFile":{
"description":"Write file to local filesystem.",
"default":false,
"type":"boolean"
},
"readDir":{
"description":"Read directory from local filesystem.",
"default":false,
"type":"boolean"
},
"copyFile":{
"description":"Copy file from local filesystem.",
"default":false,
"type":"boolean"
},
"createDir":{
"description":"Create directory from local filesystem.",
"default":false,
"type":"boolean"
},
"removeDir":{
"description":"Remove directory from local filesystem.",
"default":false,
"type":"boolean"
},
"removeFile":{
"description":"Remove file from local filesystem.",
"default":false,
"type":"boolean"
},
"renameFile":{
"description":"Rename file from local filesystem.",
"default":false,
"type":"boolean"
},
"exists":{
"description":"Check if path exists on the local filesystem.",
"default":false,
"type":"boolean"
}
},
"additionalProperties":false
},
"FsAllowlistScope":{
"description":"Filesystem scope definition. It is a list of glob patterns that restrict the API access from the webview.\n\nEach pattern can start with a variable that resolves to a system base directory. The variables are: `$AUDIO`, `$CACHE`, `$CONFIG`, `$DATA`, `$LOCALDATA`, `$DESKTOP`, `$DOCUMENT`, `$DOWNLOAD`, `$EXE`, `$FONT`, `$HOME`, `$PICTURE`, `$PUBLIC`, `$RUNTIME`, `$TEMPLATE`, `$VIDEO`, `$RESOURCE`, `$APP`, `$LOG`, `$TEMP`, `$APPCONFIG`, `$APPDATA`, `$APPLOCALDATA`, `$APPCACHE`, `$APPLOG`.",
"anyOf":[
{
"description":"A list of paths that are allowed by this scope.",
"type":"array",
"items":{
"type":"string"
}
},
{
"description":"A complete scope configuration.",
"type":"object",
"properties":{
"allow":{
"description":"A list of paths that are allowed by this scope.",
"default":[],
"type":"array",
"items":{
"type":"string"
}
},
"deny":{
"description":"A list of paths that are not allowed by this scope. This gets precedence over the [`Self::Scope::allow`] list.",
"description":"Whether or not paths that contain components that start with a `.` will require that `.` appears literally in the pattern; `*`, `?`, `**`, or `[...]` will not match. This is useful because such files are conventionally considered hidden on Unix systems and it might be desirable to skip them when listing files.\n\nDefaults to `true` on Unix systems and `false` on Windows",
"description":"Access scope for the binary execution APIs. Sidecars are automatically enabled.",
"default":[],
"allOf":[
{
"$ref":"#/definitions/ShellAllowlistScope"
}
]
},
"all":{
"description":"Use this flag to enable all shell API features.",
"default":false,
"type":"boolean"
},
"execute":{
"description":"Enable binary execution.",
"default":false,
"type":"boolean"
},
"sidecar":{
"description":"Enable sidecar execution, allowing the JavaScript layer to spawn a sidecar command, an executable that is shipped with the application. For more information see <https://tauri.app/v1/guides/building/sidecar>.",
"default":false,
"type":"boolean"
},
"open":{
"description":"Open URL with the user's default application.",
"default":false,
"allOf":[
{
"$ref":"#/definitions/ShellAllowlistOpen"
}
]
}
},
"additionalProperties":false
},
"ShellAllowlistScope":{
"description":"Shell scope definition. It is a list of command names and associated CLI arguments that restrict the API access from the webview.",
"type":"array",
"items":{
"$ref":"#/definitions/ShellAllowedCommand"
}
},
"ShellAllowedCommand":{
"description":"A command allowed to be executed by the webview API.",
"description":"The name for this allowed shell command configuration.\n\nThis name will be used inside of the webview API to call this command along with any specified arguments.",
"type":"string"
},
"cmd":{
"description":"The command name. It can start with a variable that resolves to a system base directory. The variables are: `$AUDIO`, `$CACHE`, `$CONFIG`, `$DATA`, `$LOCALDATA`, `$DESKTOP`, `$DOCUMENT`, `$DOWNLOAD`, `$EXE`, `$FONT`, `$HOME`, `$PICTURE`, `$PUBLIC`, `$RUNTIME`, `$TEMPLATE`, `$VIDEO`, `$RESOURCE`, `$APP`, `$LOG`, `$TEMP`, `$APPCONFIG`, `$APPDATA`, `$APPLOCALDATA`, `$APPCACHE`, `$APPLOG`.",
"default":"",
"type":"string"
},
"args":{
"description":"The allowed arguments for the command execution.",
"default":false,
"allOf":[
{
"$ref":"#/definitions/ShellAllowedArgs"
}
]
},
"sidecar":{
"description":"If this command is a sidecar command.",
"default":false,
"type":"boolean"
}
}
},
"ShellAllowedArgs":{
"description":"A set of command arguments allowed to be executed by the webview API.\n\nA value of `true` will allow any arguments to be passed to the command. `false` will disable all arguments. A list of [`ShellAllowedArg`] will set those arguments as the only valid arguments to be passed to the attached command configuration.",
"anyOf":[
{
"description":"Use a simple boolean to allow all or disable all arguments to this command configuration.",
"type":"boolean"
},
{
"description":"A specific set of [`ShellAllowedArg`] that are valid to call for the command configuration.",
"type":"array",
"items":{
"$ref":"#/definitions/ShellAllowedArg"
}
}
]
},
"ShellAllowedArg":{
"description":"A command argument allowed to be executed by the webview API.",
"anyOf":[
{
"description":"A non-configurable argument that is passed to the command in the order it was specified.",
"type":"string"
},
{
"description":"A variable that is set while calling the command from the webview API.",
"description":"[regex] validator to require passed values to conform to an expected input.\n\nThis will require the argument value passed to this variable to match the `validator` regex before it will be executed.\n\n[regex]: https://docs.rs/regex/latest/regex/#syntax",
"type":"string"
}
},
"additionalProperties":false
}
]
},
"ShellAllowlistOpen":{
"description":"Defines the `shell > open` api scope.",
"description":"If the shell open API should be enabled.\n\nIf enabled, the default validation regex (`^((mailto:\\w+)|(tel:\\w+)|(https?://\\w+)).+`) is used.",
"description":"Enable the shell open API, with a custom regex that the opened path must match against.\n\nIf using a custom regex to support a non-http(s) schema, care should be used to prevent values that allow flag-like strings to pass validation. e.g. `--enable-debugging`, `-i`, `/R`.",
"description":"HTTP API scope definition. It is a list of URLs that can be accessed by the webview when using the HTTP APIs. The scoped URL is matched against the request URL using a glob pattern.\n\nExamples: - \"https://*\": allows all HTTPS urls - \"https://*.github.com/tauri-apps/tauri\": allows any subdomain of \"github.com\" with the \"tauri-apps/api\" path - \"https://myapi.service.com/users/*\": allows access to any URLs that begins with \"https://myapi.service.com/users/\"",
"description":"Use this flag to enable all process APIs.",
"default":false,
"type":"boolean"
},
"relaunch":{
"description":"Enables the relaunch API.",
"default":false,
"type":"boolean"
},
"relaunchDangerousAllowSymlinkMacos":{
"description":"Dangerous option that allows macOS to relaunch even if the binary contains a symlink.\n\nThis is due to macOS having less symlink protection. Highly recommended to not set this flag unless you have a very specific reason too, and understand the implications of it.",
"description":"The Content Security Policy that will be injected on all HTML files on the built application. If [`dev_csp`](#SecurityConfig.devCsp) is not specified, this value is also injected on dev.\n\nThis is a really important part of the configuration since it helps you ensure your WebView is secured. See <https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP>.",
"anyOf":[
{
"$ref":"#/definitions/Csp"
},
{
"type":"null"
}
]
},
"devCsp":{
"description":"The Content Security Policy that will be injected on all HTML files on development.\n\nThis is a really important part of the configuration since it helps you ensure your WebView is secured. See <https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP>.",
"anyOf":[
{
"$ref":"#/definitions/Csp"
},
{
"type":"null"
}
]
},
"freezePrototype":{
"description":"Freeze the `Object.prototype` when using the custom protocol.",
"default":false,
"type":"boolean"
},
"dangerousDisableAssetCspModification":{
"description":"Disables the Tauri-injected CSP sources.\n\nAt compile time, Tauri parses all the frontend assets and changes the Content-Security-Policy to only allow loading of your own scripts and styles by injecting nonce and hash sources. This stricts your CSP, which may introduce issues when using along with other flexing sources.\n\nThis configuration option allows both a boolean and a list of strings as value. A boolean instructs Tauri to disable the injection for all CSP injections, and a list of strings indicates the CSP directives that Tauri cannot inject.\n\n**WARNING:** Only disable this if you know what you are doing and have properly configured the CSP. Your application might be vulnerable to XSS attacks without this Tauri protection.",
"description":"Allow external domains to send command to Tauri.\n\nBy default, external domains do not have access to `window.__TAURI__`, which means they cannot communicate with the commands defined in Rust. This prevents attacks where an externally loaded malicious or compromised sites could start executing commands on the user's device.\n\nThis configuration allows a set of external domains to have access to the Tauri commands. When you configure a domain to be allowed to access the IPC, all subpaths are allowed. Subdomains are not allowed.\n\n**WARNING:** Only use this option if you either have internal checks against malicious external sites or you can trust the allowed external sites. You application might be vulnerable to dangerous Tauri command related attacks otherwise.",
"description":"Sets whether the custom protocols should use `http://<scheme>.localhost` instead of the default `https://<scheme>.localhost` on Windows.\n\n**WARNING:** Using a `http` scheme will allow mixed content when trying to fetch `http` endpoints and is therefore less secure but will match the behavior of the `<scheme>://localhost` protocols used on macOS and Linux.",
"description":"The list of plugins that are allowed in this scope. The names should be without the `tauri-plugin-` prefix, for example `\"store\"` for `tauri-plugin-store`.",
"description":"Whether the updater is active or not.",
"default":false,
"type":"boolean"
},
"dialog":{
"description":"Display built-in dialog or use event system if disabled.",
"default":true,
"type":"boolean"
},
"endpoints":{
"description":"The updater endpoints. TLS is enforced on production.\n\nThe updater URL can contain the following variables: - {{current_version}}: The version of the app that is requesting the update - {{target}}: The operating system name (one of `linux`, `windows` or `darwin`). - {{arch}}: The architecture of the machine (one of `x86_64`, `i686`, `aarch64` or `armv7`).\n\n# Examples - \"https://my.cdn.com/latest.json\": a raw JSON endpoint that returns the latest version and download links for each platform. - \"https://updates.app.dev/{{target}}?version={{current_version}}&arch={{arch}}\": a dedicated API with positional and query string arguments.",
"description":"Path to the default icon to use on the system tray.",
"type":"string"
},
"iconAsTemplate":{
"description":"A Boolean value that determines whether the image represents a [template](https://developer.apple.com/documentation/appkit/nsimage/1520017-template?language=objc) image on macOS.",
"default":false,
"type":"boolean"
},
"menuOnLeftClick":{
"description":"A Boolean value that determines whether the menu should appear when the tray icon receives a left click on macOS.",
"description":"The path to the application assets or URL to load in development.\n\nThis is usually an URL to a dev server, which serves your application assets with live reloading. Most modern JavaScript bundlers provides a way to start a dev server by default.\n\nSee [vite](https://vitejs.dev/guide/), [Webpack DevServer](https://webpack.js.org/configuration/dev-server/) and [sirv](https://github.com/lukeed/sirv) for examples on how to set up a dev server.",
"default":"http://localhost:8080/",
"allOf":[
{
"$ref":"#/definitions/AppUrl"
}
]
},
"distDir":{
"description":"The path to the application assets or URL to load in production.\n\nWhen a path relative to the configuration file is provided, it is read recursively and all files are embedded in the application binary. Tauri then looks for an `index.html` file unless you provide a custom window URL.\n\nYou can also provide a list of paths to be embedded, which allows granular control over what files are added to the binary. In this case, all files are added to the root and you must reference it that way in your HTML files.\n\nWhen an URL is provided, the application won't have bundled assets and the application will load that URL by default.",
"default":"../dist",
"allOf":[
{
"$ref":"#/definitions/AppUrl"
}
]
},
"beforeDevCommand":{
"description":"A shell command to run before `tauri dev` kicks in.\n\nThe TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.",
"anyOf":[
{
"$ref":"#/definitions/BeforeDevCommand"
},
{
"type":"null"
}
]
},
"beforeBuildCommand":{
"description":"A shell command to run before `tauri build` kicks in.\n\nThe TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.",
"anyOf":[
{
"$ref":"#/definitions/HookCommand"
},
{
"type":"null"
}
]
},
"beforeBundleCommand":{
"description":"A shell command to run before the bundling phase in `tauri build` kicks in.\n\nThe TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.",
"anyOf":[
{
"$ref":"#/definitions/HookCommand"
},
{
"type":"null"
}
]
},
"features":{
"description":"Features passed to `cargo` commands.",
"description":"The plugin configs holds a HashMap mapping a plugin name to its configuration object.\n\nSee more: https://tauri.app/v1/api/config#pluginconfig",
