Merge pull request #9 from tuist/feature/turborepo-support

Add TurboRepo Remote Caching Support with Zero-Configuration Setup

Author: pepicrft

.github/workflows/fabrik.yml

@@ -83,7 +83,7 @@ jobs:
         if: runner.os == 'macOS'
         uses: maxim-lobanov/setup-xcode@v1
         with:
-          xcode-version: latest-stable
+          xcode-version: '16.0'
 
       - name: Install Rust
         uses: dtolnay/rust-toolchain@stable
@@ -127,7 +127,7 @@ jobs:
         if: runner.os == 'macOS'
         uses: maxim-lobanov/setup-xcode@v1
         with:
-          xcode-version: latest-stable
+          xcode-version: '16.0'
 
       - name: Install Rust
         uses: dtolnay/rust-toolchain@stable

.gitignore

@@ -2,6 +2,9 @@
 /target
 *.pdb
 
+# Fabrik cache
+.fabrik/
+
 # Release artifacts
 /dist
 

docs/.vitepress/config.mts

@@ -40,6 +40,10 @@ export default defineConfig({
             text: '<span class="sidebar-icon-text"><img src="/images/nx.svg" class="sidebar-icon" alt="Nx">Nx</span>',
             link: "/build-systems/nx",
           },
+          {
+            text: '<span class="sidebar-icon-text"><img src="/images/turborepo-icon.svg" class="sidebar-icon" alt="TurboRepo">TurboRepo</span>',
+            link: "/build-systems/turborepo",
+          },
           {
             text: '<span class="sidebar-icon-text"><img src="/images/xcode.png" class="sidebar-icon" alt="Xcode">Xcode</span>',
             link: "/build-systems/xcode",

docs/build-systems/README.md

@@ -17,7 +17,7 @@ The guides below focus on **build system-specific** configuration and tips.
 - **[Gradle](./gradle)** - Java, Kotlin, Android projects
 - **[Bazel](./bazel)** - Multi-language monorepos *(coming soon)*
 - **[Nx](./nx)** - JavaScript/TypeScript monorepos *(coming soon)*
-- **TurboRepo** - JavaScript/TypeScript monorepos *(coming soon)*
+- **[TurboRepo](./turborepo)** - JavaScript/TypeScript monorepos
 
 ### Platform-Specific
 
@@ -67,7 +67,9 @@ Fabrik exports these for different build tools:
 | `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_TOKEN` | TurboRepo | TurboRepo auth (future) |
+| `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

docs/build-systems/turborepo.md

@@ -0,0 +1,22 @@
+# TurboRepo Integration
+
+TurboRepo integration guide for Fabrik. This assumes you've already [completed the getting started guide](/getting-started).
+
+## How It Works
+
+Fabrik provides remote caching for TurboRepo via the v8 HTTP API. When you navigate to your project, Fabrik automatically exports:
+
+- `TURBO_API` - Points to Fabrik's HTTP cache server
+- `TURBO_TOKEN` - Auto-generated for authentication
+- `TURBO_TEAM` - Auto-generated team identifier
+
+TurboRepo automatically detects these environment variables and enables remote caching.
+
+## Quick Start
+
+```bash
+cd ~/my-turborepo-workspace
+turbo run build
+```
+
+That's it! TurboRepo will automatically use Fabrik's cache via the environment variables.

docs/images/turborepo-icon.svg

@@ -0,0 +1,4 @@
+node_modules
+dist
+.turbo
+.npmrc

fixtures/turborepo/.gitignore

@@ -0,0 +1,12 @@
+{
+  "name": "turborepo-fixture",
+  "version": "1.0.0",
+  "private": true,
+  "packageManager": "npm@11.0.0",
+  "workspaces": [
+    "packages/*"
+  ],
+  "devDependencies": {
+    "turbo": "latest"
+  }
+}

fixtures/turborepo/package.json

@@ -0,0 +1,23 @@
+const fs = require('fs');
+const path = require('path');
+
+// Create dist directory
+const distDir = path.join(__dirname, 'dist');
+if (!fs.existsSync(distDir)) {
+  fs.mkdirSync(distDir, { recursive: true });
+}
+
+// Generate some output
+const output = {
+  message: 'Build complete!',
+  timestamp: new Date().toISOString(),
+  platform: process.platform,
+};
+
+fs.writeFileSync(
+  path.join(distDir, 'output.json'),
+  JSON.stringify(output, null, 2)
+);
+
+console.log('✅ Build complete!');
+console.log('   Output:', path.join(distDir, 'output.json'));

fixtures/turborepo/packages/app/build.js

@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "node build.js"
+  }
+}