Introduction
What is Tuzzle and why you should use it for media management.
Tuzzle is a digital asset management (DAM) platform for developers and businesses. It handles image and media upload, storage, on-the-fly transformation, and delivery via CDN.
What Tuzzle Does
- Upload files through authenticated, signed, unsigned, or presigned methods
- Transform images on the fly with resize, crop, format conversion, quality control, and face detection
- Deliver assets through a global CDN with caching, signed URLs, and access control
- Manage files, folders, and spaces with a REST API
Architecture
Tuzzle consists of two core services:
| Service | Purpose |
|---|---|
API (api.tzzl.io) | Upload, storage, management |
CDN (cdn.tzzl.io) | Delivery, transformation, caching |
Both services connect to the same cloud storage. The API handles uploads and management, while the CDN handles delivery and image processing.
Upload: Client -> API -> Cloud Storage
Deliver: Client -> CDN -> Cloud Storage -> Process -> Cache -> Response
Key Features
Multi-Tenant Spaces
Organize assets into isolated spaces, each with its own API keys, access controls, and upload configurations.
On-the-Fly Transformations
Transform images using URL query parameters. No pre-processing needed.
https://cdn.tzzl.io/my-space/photo.jpg?w=400&h=300&f=webp&q=80
Three Access Levels
- Public (
upload): No authentication required - Private (
private): Signed URL required for generation, public delivery after signing - Authenticated (
authenticated): Authentication required for both generation and delivery
Face Detection
AI-powered face detection for smart cropping and thumbnails.
Blurhash Placeholders
Automatic blurhash generation for image placeholders during loading.
Next Steps
- Quick Start: Get up and running in 5 minutes
- Concepts: Understand the core terminology
- Authentication: Set up API access