Loading...

Turborepo Remote Cache

A high-performance remote cache implementation for Turborepo built with Next.js and Hono

High Performance
Built with Hono for edge runtime performance
Type Safe
Full TypeScript support with Zod validation
OpenAPI Compatible
Follows Turborepo's official API specification

API Endpoints

Cache Status

GET /api/v8/artifacts/status

Check if remote caching is enabled

Upload Artifact

PUT /api/v8/artifacts/{hash}

Upload a cache artifact by hash

Download Artifact

GET /api/v8/artifacts/{hash}

Download a cached artifact by hash

Query Artifacts

POST /api/v8/artifacts

Query information about multiple artifacts

Record Events

POST /api/v8/artifacts/events

Record cache usage events (HIT/MISS)

Getting Started

To use this remote cache with your Turborepo project, configure your turbo.json:

{
  "remoteCache": {
    "signature": true
  }
}

Then set your remote cache URL and authentication token:

npx turbo login --api="http://localhost:6969/api/v8"
npx turbo link