Build System Integration

Build system-specific integration guides for Fabrik.

Note: This section assumes you've already completed the Getting Started Guide which covers:

• Installing Fabrik
• Setting up shell integration
• Running fabrik init
• Verifying with fabrik doctor

The guides below focus on build system-specific configuration and tips.

Supported Build Systems

Build Systems

• Gradle - Java, Kotlin, Android projects
• Bazel - Multi-language monorepos (coming soon)
• Nx - JavaScript/TypeScript monorepos (coming soon)
• TurboRepo - JavaScript/TypeScript monorepos

Platform-Specific

• Xcode - iOS, macOS, watchOS, tvOS apps (coming soon)

Compiler Caches

• sccache - Rust, C, C++ compiler cache (coming soon)

What These Guides Cover

Each build system guide includes:

• How it works - How Fabrik integrates with the build system
• Quick start - Minimal example to get started
• Configuration examples - Build system-specific configurations
• Advanced tips - Performance optimization and best practices
• Troubleshooting - Common issues and solutions
• CI/CD integration - Examples for popular CI platforms

What These Guides DON'T Cover

Setup instructions that are common to all build systems:

• ❌ Installing Fabrik (see Getting Started)
• ❌ Shell integration setup (see Getting Started)
• ❌ Running fabrik init (see Getting Started)
• ❌ Basic troubleshooting with fabrik doctor (see Getting Started)

General Pattern

All build systems follow the same pattern:

1. Navigate to project: cd ~/myproject
2. Daemon starts automatically: Fabrik detects fabrik.toml
3. Environment variables exported: Build tool-specific URLs
4. Build tool reads env var: Connects to daemon automatically
5. Cache magic happens: Builds are faster! 🚀

Environment Variables

Fabrik exports these for different build tools:

Variable	Build Systems	Purpose
FABRIK_HTTP_URL	All HTTP-based	Generic HTTP cache URL
FABRIK_GRPC_URL	Bazel, Buck2	gRPC cache URL
GRADLE_BUILD_CACHE_URL	Gradle	Gradle-specific cache URL
NX_SELF_HOSTED_REMOTE_CACHE_SERVER	Nx	Nx-specific cache URL
TURBO_API	TurboRepo	TurboRepo cache server URL
TURBO_TOKEN	TurboRepo	Auth token (auto-generated)
TURBO_TEAM	TurboRepo	Team slug (auto-generated)
XCODE_CACHE_SERVER	Xcode	Xcode cache URL

Example Configuration

A typical fabrik.toml works for all build systems:

# Local cache only
[cache]
dir = ".fabrik/cache"
max_size = "5GB"

Or with remote cache:

# With remote cache
[cache]
dir = ".fabrik/cache"
max_size = "5GB"

[[upstream]]
url = "grpc://cache.tuist.io:7070"
timeout = "30s"

[auth]
token_file = ".fabrik.token"

See Also

• Getting Started Guide - Setup instructions
• CLI Reference - Command documentation
• Architecture - Deep dive into Fabrik internals