# RFCs

**URL:** https://community.tuist.dev/c/rfc/14.md

[Latest](https://community.tuist.dev/latest.md) · [Categories](https://community.tuist.dev/categories.md) · [Tags](https://community.tuist.dev/tags.md)

---

## [About the RFCs category](https://community.tuist.dev/t/about-the-rfcs-category/101)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 0\
**Last updated:** [October 15, 2024, 8:19pm UTC](https://community.tuist.dev/t/about-the-rfcs-category/101 "2024-10-15T20:19:27Z")

</div>

RFCs (requests for comments) are detailed proposals for important changes in Tuist. Use these to get both the community and the core team feedback before moving to the implementation phase.

---

## [RFC: Custom Code Generators for Tuist Targets](https://community.tuist.dev/t/rfc-custom-code-generators-for-tuist-targets/1004)

<div class="topic-metadata">

**Author:** [@hiltonc](https://community.tuist.dev/u/hiltonc)\
**Replies:** 3\
**Last updated:** [August 31, 2026, 9:38pm UTC](https://community.tuist.dev/t/rfc-custom-code-generators-for-tuist-targets/1004 "2026-08-31T21:38:25Z")

</div>

Summary This RFC proposes codeGenerators: on a Tuist target: a declaration that a command produces some of the target’s sources from a declared set of inputs. Tuist runs the command, attaches its output directory to the …

---

## [RFC: Release channels and a stable line teams can trust](https://community.tuist.dev/t/rfc-release-channels-and-a-stable-line-teams-can-trust/994)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 4\
**Last updated:** [June 11, 2026, 2:14pm UTC](https://community.tuist.dev/t/rfc-release-channels-and-a-stable-line-teams-can-trust/994 "2026-06-11T14:14:57Z")

</div>

Summary This RFC proposes splitting the Tuist CLI release stream into three channels (canary, rc, and stable) so that the version teams install by default changes slowly, is feature-frozen, and receives backported fixes.…

---

## [Self-hosted GitHub Actions cache for Tuist Runners](https://community.tuist.dev/t/self-hosted-github-actions-cache-for-tuist-runners/989)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 2\
**Last updated:** [June 2, 2026, 2:16pm UTC](https://community.tuist.dev/t/self-hosted-github-actions-cache-for-tuist-runners/989 "2026-06-02T14:16:32Z")

</div>

This RFC proposes a self-hosted GitHub Actions cache backend for Tuist Runners, co-located with each runner fleet. Today, a customer job running on a Tuist runner still ships its actions/cache traffic across the internet…

---

## [Moving Postgres in-cluster](https://community.tuist.dev/t/moving-postgres-in-cluster/986)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 6\
**Last updated:** [May 21, 2026, 8:24am UTC](https://community.tuist.dev/t/moving-postgres-in-cluster/986 "2026-05-21T08:24:20Z")

</div>

Summary This RFC proposes migrating the Tuist server’s primary Postgres database off Supabase and into our self-hosted CAPI Kubernetes clusters on Hetzner, managed by the CloudNativePG operator. ClickHouse stays on its c…

---

## [RFC: Code Coverage and Test Impact Analysis](https://community.tuist.dev/t/rfc-code-coverage-and-test-impact-analysis/983)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 3\
**Last updated:** [May 13, 2026, 1:32pm UTC](https://community.tuist.dev/t/rfc-code-coverage-and-test-impact-analysis/983 "2026-05-13T13:32:53Z")

</div>

Summary This RFC proposes adding code coverage as a first-class Tuist platform capability, then using the collected coverage evidence to power coverage-backed Test Impact Analysis (TIA) for Gradle projects and non-genera…

---

## [RFC: Hardening bounded contexts and dependency boundaries in Tuist Server](https://community.tuist.dev/t/rfc-hardening-bounded-contexts-and-dependency-boundaries-in-tuist-server/975)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 0\
**Last updated:** [April 28, 2026, 3:11pm UTC](https://community.tuist.dev/t/rfc-hardening-bounded-contexts-and-dependency-boundaries-in-tuist-server/975 "2026-04-28T15:11:46Z")

</div>

Summary This RFC proposes a more disciplined internal architecture for the Tuist server monolith. The goal is not to split the server into services, nor to introduce a new global workflow layer, nor to decompose the code…

---

## [Per-account \`/metrics\` endpoint and Grafana integration](https://community.tuist.dev/t/per-account-metrics-endpoint-and-grafana-integration/974)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 2\
**Last updated:** [April 21, 2026, 10:21am UTC](https://community.tuist.dev/t/per-account-metrics-endpoint-and-grafana-integration/974 "2026-04-21T10:21:34Z")

</div>

Summary This RFC proposes a per-customer Prometheus-compatible /metrics endpoint that customers can scrape to pull live build, test, cache, and CLI command metrics out of Tuist, and a Grafana app plugin that bundles a …

---

## [RFC: Preview notifications & a pluggable notification engine](https://community.tuist.dev/t/rfc-preview-notifications-a-pluggable-notification-engine/973)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 0\
**Last updated:** [April 16, 2026, 5:08pm UTC](https://community.tuist.dev/t/rfc-preview-notifications-a-pluggable-notification-engine/973 "2026-04-16T17:08:21Z")

</div>

1. Summary Users want to be notified when a new preview is published to Tuist, with per‑branch filtering (e.g. “only main/develop”), delivered through the channel that fits their workflow — Slack, email, or a push notifi…

---

## [RFC: Webhooks for Tuist Events](https://community.tuist.dev/t/rfc-webhooks-for-tuist-events/969)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 2\
**Last updated:** [April 12, 2026, 1:42pm UTC](https://community.tuist.dev/t/rfc-webhooks-for-tuist-events/969 "2026-04-12T13:42:50Z")

</div>

Summary This RFC proposes a general-purpose webhook system for Tuist, modeled after Stripe’s event and webhook infrastructure. Teams can register HTTPS endpoints and subscribe to event types across any Tuist entity (test…

---

## [Automations evolution](https://community.tuist.dev/t/automations-evolution/964)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 3\
**Last updated:** [April 8, 2026, 5:53pm UTC](https://community.tuist.dev/t/automations-evolution/964 "2026-04-08T17:53:55Z")

</div>

Summary We propose a unified automation system for Tuist, inspired by Buildkite Workflows and Shopify Functions. Automations replace all current hardcoded project settings (flaky detection, quarantine, Slack alerts, perf…

---

## [Adding mute and skip quarantine modes](https://community.tuist.dev/t/adding-mute-and-skip-quarantine-modes/961)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 1\
**Last updated:** [March 30, 2026, 10:21am UTC](https://community.tuist.dev/t/adding-mute-and-skip-quarantine-modes/961 "2026-03-30T10:21:14Z")

</div>

Context Until recently, quarantining a test in Tuist meant fully skipping it during test execution. We changed this behavior so quarantined tests still run but their failures no longer affect the CI exit code (mute mode)…

---

## [Skipping overhead for --without-building selective testing phase](https://community.tuist.dev/t/skipping-overhead-for-without-building-selective-testing-phase/947)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 1\
**Last updated:** [March 23, 2026, 1:08pm UTC](https://community.tuist.dev/t/skipping-overhead-for-without-building-selective-testing-phase/947 "2026-03-23T13:08:15Z")

</div>

Summary Extend tuist test --build-only to produce a self-contained .xctestproducts bundle that embeds the selective testing graph and all metadata needed to run tests. The corresponding tuist test --without-building stag…

---

## [Adjust quarantine behavior](https://community.tuist.dev/t/adjust-quarantine-behavior/945)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 1\
**Last updated:** [March 20, 2026, 4:09pm UTC](https://community.tuist.dev/t/adjust-quarantine-behavior/945 "2026-03-20T16:09:34Z")

</div>

Summary This RFC proposes changing test quarantine behavior from skipping quarantined tests entirely to running them but overriding the exit status when quarantined tests fail. This aligns with industry practice and solv…

---

## [Distributed Key-Value Store for Cache Nodes](https://community.tuist.dev/t/distributed-key-value-store-for-cache-nodes/939)

<div class="topic-metadata">

**Author:** [@cschmatzler](https://community.tuist.dev/u/cschmatzler)\
**Replies:** 3\
**Last updated:** [March 12, 2026, 11:13am UTC](https://community.tuist.dev/t/distributed-key-value-store-for-cache-nodes/939 "2026-03-12T11:13:14Z")

</div>

Abstract This RFC proposes adding an eventually-consistent distributed replication layer to the cache service’s key-value store. Today, KV entries live in per-node SQLite databases, causing inconsistent hit/miss behavior…

---

## [Enhancing Tuist's \`graph\` Command with Interactive Graph](https://community.tuist.dev/t/enhancing-tuists-graph-command-with-interactive-graph/225)

<div class="topic-metadata">

**Author:** [@ajkolean](https://community.tuist.dev/u/ajkolean)\
**Replies:** 6\
**Last updated:** [March 10, 2026, 11:50pm UTC](https://community.tuist.dev/t/enhancing-tuists-graph-command-with-interactive-graph/225 "2026-03-10T23:50:59Z")

</div>

RFC: Enhancing Tuist’s graph Command with Interactive Visualization Using a CDN-Hosted xcode-graph-component Author: Andy Kolean GitHub: GitHub Need/Problem Tuist’s existing graph command generates static images of a…

---

## [RFC: Test Sharding](https://community.tuist.dev/t/rfc-test-sharding/929)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 5\
**Last updated:** [March 6, 2026, 6:27pm UTC](https://community.tuist.dev/t/rfc-test-sharding/929 "2026-03-06T18:27:58Z")

</div>

Summary This RFC proposes adding test sharding to Tuist, allowing users to split their test suites across multiple CI runners for faster feedback loops. The system will distribute tests across shards using timing data co…

---

## [Server-Side xcactivitylog Processing](https://community.tuist.dev/t/server-side-xcactivitylog-processing/928)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 5\
**Last updated:** [March 6, 2026, 10:30am UTC](https://community.tuist.dev/t/server-side-xcactivitylog-processing/928 "2026-03-06T10:30:10Z")

</div>

Summary Move xcactivitylog parsing from the CLI (client-side) to a dedicated server-side processing pipeline. Instead of parsing logs locally and uploading structured data, the CLI would upload raw .xcactivitylog files t…

---

## [RFC: Comparison Primitives for MCP, CLI, and Agent Skills](https://community.tuist.dev/t/rfc-comparison-primitives-for-mcp-cli-and-agent-skills/925)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 7\
**Last updated:** [March 5, 2026, 11:37am UTC](https://community.tuist.dev/t/rfc-comparison-primitives-for-mcp-cli-and-agent-skills/925 "2026-03-05T11:37:07Z")

</div>

Summary This RFC proposes adding comparison workflows to Tuist by combining existing data-fetching tools/commands with new MCP prompts and a CLI skill that guide AI agents through structured comparisons. No new server-si…

---

## [RFC: Bundle Size CI Check Threshold](https://community.tuist.dev/t/rfc-bundle-size-ci-check-threshold/923)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 2\
**Last updated:** [March 4, 2026, 10:02am UTC](https://community.tuist.dev/t/rfc-bundle-size-ci-check-threshold/923 "2026-03-04T10:02:39Z")

</div>

Summary Add bundle size threshold checks to tuist inspect bundle via GitHub Check Runs. When a bundle is uploaded and a threshold is exceeded, the server posts a check run with an action\_required conclusion and an “Accep…

---

## [Warnings as errors RFC](https://community.tuist.dev/t/warnings-as-errors-rfc/907)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 2\
**Last updated:** [February 24, 2026, 12:29pm UTC](https://community.tuist.dev/t/warnings-as-errors-rfc/907 "2026-02-24T12:29:25Z")

</div>

RFC: Selective Warnings as Errors in tuist generate Summary Allow project maintainers to promote specific generation warnings to errors via GenerationOptions in Tuist.swift, so that tuist generate fails immediately when …

---

## [RFC: \`tuist.toml\` as a Swift-free configuration alternative](https://community.tuist.dev/t/rfc-tuist-toml-as-a-swift-free-configuration-alternative/889)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 1\
**Last updated:** [February 6, 2026, 9:10am UTC](https://community.tuist.dev/t/rfc-tuist-toml-as-a-swift-free-configuration-alternative/889 "2026-02-06T09:10:05Z")

</div>

Summary This RFC proposes adding support for a tuist.toml configuration file as an alternative to Tuist.swift. The primary motivation is enabling a practical experience on Linux, where Swift may not be installed and Tuis…

---

## [Build metadata and tags](https://community.tuist.dev/t/build-metadata-and-tags/885)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 3\
**Last updated:** [February 2, 2026, 2:37pm UTC](https://community.tuist.dev/t/build-metadata-and-tags/885 "2026-02-02T14:37:49Z")

</div>

RFC: Custom Build Metadata for Tuist Insights Summary This RFC proposes adding support for custom metadata (tags and key-value pairs) to Tuist’s build insights feature. Teams will be able to attach arbitrary metadata to …

---

## [RFC: External Build System Dependencies](https://community.tuist.dev/t/rfc-external-build-system-dependencies/879)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 2\
**Last updated:** [February 2, 2026, 12:15pm UTC](https://community.tuist.dev/t/rfc-external-build-system-dependencies/879 "2026-02-02T12:15:00Z")

</div>

The topic of supporting Kotlin multiplatform is something that came up a few times, so I decided to iterate on a potential design with Claude Code in a way that users of generated projects can declare not only a dependen…

---

## [RFC: Project Markers for Decision Tracking](https://community.tuist.dev/t/rfc-project-markers-for-decision-tracking/855)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 3\
**Last updated:** [December 30, 2025, 9:49am UTC](https://community.tuist.dev/t/rfc-project-markers-for-decision-tracking/855 "2025-12-30T09:49:53Z")

</div>

Need/Problem Teams and developers make decisions that might have an impact on their projects’ metrics. For example, changing CI providers or setting a build setting across projects. While they can see the impact through …

---

## [Evolving Tuist tokens](https://community.tuist.dev/t/evolving-tuist-tokens/836)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 11\
**Last updated:** [December 10, 2025, 9:13pm UTC](https://community.tuist.dev/t/evolving-tuist-tokens/836 "2025-12-10T21:13:35Z")

</div>

Need/problem We have recently added two new ways to authenticate: OIDC tokens, a more secure and convenient way to authenticate on supported CI providers Account tokens, offering a flexible way to communicate with the …

---

## [Taking Tuist QA to the next level](https://community.tuist.dev/t/taking-tuist-qa-to-the-next-level/710)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 3\
**Last updated:** [August 11, 2025, 7:31am UTC](https://community.tuist.dev/t/taking-tuist-qa-to-the-next-level/710 "2025-08-11T07:31:48Z")

</div>

We’re getting close to unlocking our first Tuist QA workflow: PR is created with your changes tuist share is run as part of the CI You run the Tuist QA by adding a comment such as /tuist qa Test my featureX Tuist spins…

---

## [Introduce Apply Each build rule](https://community.tuist.dev/t/introduce-apply-each-build-rule/676)

<div class="topic-metadata">

**Author:** [@pbk20191](https://community.tuist.dev/u/pbk20191)\
**Replies:** 1\
**Last updated:** [July 23, 2025, 7:55am UTC](https://community.tuist.dev/t/introduce-apply-each-build-rule/676 "2025-07-23T07:55:20Z")

</div>

Summary Introduce a way to specify Xcode’s “Apply Each Build Rule” folder references in Tuist projects to improve scalability and build performance when dealing with very large collections of resources, such as .xib, .st…

---

## [Improve debugging of CLI issues](https://community.tuist.dev/t/improve-debugging-of-cli-issues/618)

<div class="topic-metadata">

**Author:** [@marekfort](https://community.tuist.dev/u/marekfort)\
**Replies:** 4\
**Last updated:** [June 17, 2025, 9:55am UTC](https://community.tuist.dev/t/improve-debugging-of-cli-issues/618 "2025-06-17T09:55:52Z")

</div>

Need/problem When CLI issues occur, it’s important that developers have an easy way to debug what has happened – and to be able to provide the Tuist team with the necessary context. We’ve already done a great step in th…

---

## [Turning \`tuist/tuist\` into a monorepo](https://community.tuist.dev/t/turning-tuist-tuist-into-a-monorepo/614)

<div class="topic-metadata">

**Author:** [@pepicrft](https://community.tuist.dev/u/pepicrft)\
**Replies:** 3\
**Last updated:** [June 11, 2025, 4:23pm UTC](https://community.tuist.dev/t/turning-tuist-tuist-into-a-monorepo/614 "2025-06-11T16:23:38Z")

</div>

Need/problem With our plans to make the server source code available, and also provide an SDK that developers can add to their apps to bring runtime capabilities, like runtime intelligence (like Tidewave), I think this p…

[Next page](https://community.tuist.dev/c/rfc/14.md?page=1)
