გადახტე შინაარსზე

tuist.toml

tuist.toml is a build-system agnostic configuration file and an evolution of Tuist.swift. Unlike Tuist.swift, it does not require Swift, making it usable across any platform and build system. It is ideal for environments where Swift is not available, such as Linux-based CI runners, or when you only need to configure server-related settings without a full Tuist.swift manifest.

Tuist looks for tuist.toml by traversing the directory hierarchy upward from the current working directory, stopping at the first match. This means you can place it at the root of your project and run Tuist commands from any subdirectory.

Supported keys#

KeyTypeRequiredDefaultDescription
projectStringYes—The full handle of your project (e.g. "tuist/tuist").
urlStringNohttps://tuist.devThe URL of the Tuist server.

Network#

The [network] table configures how Tuist makes outbound HTTP connections.

KeyTypeRequiredDefaultDescription
proxyBooleanNotrueWhen true, Tuist uses the proxy defined by HTTPS_PROXY/HTTP_PROXY when present. See the HTTP proxy guide.
ca_certificateStringNo—Path to a PEM or DER CA certificate bundle to trust on top of the system root store, for example for a self-hosted server that uses a private CA. The TUIST_CA_CERTIFICATE environment variable takes precedence. See trusting a custom CA certificate.

Example#

toml
project = "tuist/tuist"
url = "https://tuist.dev"
[network]
proxy = true
ca_certificate = "/etc/ssl/certs/self-hosted-ca.pem"

Configuration precedence#

When the same setting is defined in multiple places, Tuist resolves it using the following precedence order (highest to lowest):

  1. CLI flags
  2. Environment variables
  3. Tuist.swift
  4. tuist.toml
  5. Defaults