🚀 Cache Rocket v1.0.0

Supercharge your Turborepo builds with a blazing-fast remote cache server!

Cache Rocket is a comprehensive GitHub Action that automatically starts and manages the powerful turborepo-remote-cache server during your CI/CD workflows, eliminating manual setup and configuration headaches.

✨ Key Features

• 🚀 Auto-discovers available ports to avoid conflicts
• ⚡ Manages server lifecycle (start/stop) automatically
• 🔐 Generates secure tokens for each workflow run
• 🌐 Configures all environment variables Turborepo needs
• 📋 Captures and displays logs for easy debugging
• ☁️ Multi-cloud support (S3, Google Cloud Storage, Azure Blob Storage)

🚀 Quick Start

- name: 🚀 Launch Cache Rocket
  uses: freddyfallon/cache-rocket@v1.0.0
  with:
    storage-provider: s3
    storage-path: my-turborepo-cache-bucket
  env:
    AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
    AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    AWS_REGION: us-east-1

- name: Build with Turbo
  run: npx turbo build
  # Cache Rocket automatically sets TURBO_API, TURBO_TOKEN, and TURBO_TEAM

🛠️ Technical Highlights

• Modern TypeScript with Zod validation and comprehensive error handling
• Extensive test suite (43 tests, 95%+ coverage) using Vitest
• ESLint v9 flat config with strict TypeScript rules
• Automated port discovery using portfinder to avoid conflicts
• Graceful cleanup with proper SIGTERM signal handling
• Zero configuration - works out of the box with sensible defaults

📚 Full Documentation

See the README for complete usage examples, configuration options, and troubleshooting guides.

🙏 Attribution

Cache Rocket is powered by the excellent turborepo-remote-cache project by Ducktors. We provide the GitHub Actions integration layer with zero-configuration setup.