Tuist Server

This repository contains the source code of the server-side application that extends the functionality of the Tuist CLI.

Contributing

Contributions to the Tuist Server require signing a Contributor License Agreement (CLA). Please see CLA.md for details before submitting pull requests that modify server components.

Development

Requirements

Set up

Clone the repository: git clone https://github.com/tuist/tuist.git.
Open the folder: cd server.
Install system dependencies with: mise install.
Start Postgres with: brew services start postgresql@16.
Start ClickHouse with: mise run clickhouse:start
Install dependencies: mise run install
Create and set up the database: mise run db:setup
Run the server: mise run dev
Open the local URL for your current clone or worktree in your browser and log in with the pre-made test user account. With mise activate enabled, each checkout persists its own numeric suffix through Git metadata when available, while keeping the existing root .tuist-dev-instance file as a compatibility fallback. That suffix scopes the local service ports, MinIO ports, and the PostgreSQL and ClickHouse database names, while the local ClickHouse daemon itself stays shared across checkouts. For example, a suffix of 443 yields http://localhost:8523:

Email: [email protected]
Pass: tuistrocks

[!NOTE] First-party developers can load encrypted secrets from priv/secrets/dev.key. External contributors don't need this key — the server runs locally without it. OAuth, Stripe, and other third-party integrations will be disabled, but core functionality works.

To run additional features

Clone the repository: https://github.com/tuist/tuist.git.
Go to tuist/examples/xcode/generated_ios_app_with_frameworks.
Change the url in Tuist.swift to the local URL for the current clone or worktree, for example http://localhost:8523.
Run tuist auth to authenticate.
You are now connected to the local Tuist Server! You can try running tuist cache and see the binaries being uploaded.