Tigris Static Asset Hosting

Cache-Control

Prerequisites

tigris help || npm install -g @tigrisdata/cli

@tigrisdata/cli

Overview

1. Build assets with content hashes (e.g.,

   main-abc123.js

   )
2. Upload to a public Tigris bucket
3. Set

   Cache-Control: public, max-age=31536000, immutable

4. Point your app's asset URL to the Tigris bucket

Cache Headers

# For immutable, hashed assets (CSS, JS bundles)
Cache-Control: public, max-age=31536000, immutable

# For mutable assets (manifest files, index.html)
Cache-Control: public, max-age=0, must-revalidate

# For fonts
Cache-Control: public, max-age=31536000, immutable

Setting Headers via CLI

tigris cp dist/main-abc123.js t3://my-assets/main-abc123.js \
  --cache-control "public, max-age=31536000, immutable" \
  --content-type "application/javascript"

Setting Headers via SDK

import { put } from "@tigrisdata/storage";

await put("assets/main-abc123.js", fileBuffer, {
  access: "public",
  contentType: "application/javascript",
});

Upload Script (General)

#!/bin/bash
# scripts/deploy-assets.sh
BUCKET="my-app-assets"
BUILD_DIR="dist"

# Upload hashed assets with long cache
tigris cp "$BUILD_DIR/" "t3://$BUCKET/" -r \
  --cache-control "public, max-age=31536000, immutable"

echo "Assets deployed to t3://$BUCKET/"

Framework Guides

• Next.js — Read

  ./resources/nextjs.md

  for assetPrefix config and deploy script
• Remix — Read

  ./resources/remix.md

  for Vite config and deploy script
• Express — Read

  ./resources/express.md

  for static redirect pattern
• Rails — Read

  ./resources/rails.md

  for Sprockets/Propshaft asset sync
• Django — Read

  ./resources/django.md

  for collectstatic with S3 backend
• Laravel — Read

  ./resources/laravel.md

  for Vite/Mix asset upload

Cache-Busting Strategies

main-abc123.js

main.js?v=abc123

/v2/assets/main.js

immutable

Critical Rules

Cache-Control: immutable

Related Skills

• tigris-egress-optimizer — Reduce bandwidth costs
• tigris-lifecycle-management — Clean up old asset versions

Official Documentation

• Tigris: https://www.tigrisdata.com/docs/