Overview
Start here for the core idea behind Better Media and the path through the docs.
Better Media is a unified framework designed to bring your entire media ecosystem into one predictable interface. Instead of manually stitching together storage clients, database records, background jobs, and validation logic for every new project, Better Media provides a centralized foundation for handling the full lifecycle of your files.
Without a unified framework, developers often waste days setting up the same infrastructure for every project:
- Repetitive Configuration: Manually setting up multipart parsers and S3 clients.
- Boilerplate Schemas: Designing custom database tables for file metadata.
- Infrastructure Glue: Writing custom logic for folder structures and cleanup.
- Complex Integration: Hand-rolling background job orchestration for transcoding.
What Better Media Solves
Better Media puts everything in one place. It acts as a single "home" for your media logic.
Centralized Config
Define your storage, database, and job settings once. No more scattered logic.
Eliminate Boilerplate
Use high-level APIs for ingest and processing without worrying about the infrastructure.
Extreme Flexibility
Swap implementations (e.g., Local to S3) easily without rewriting your application code.
Key Benefits
- Unified Interface: A single, type-safe API for the entire media lifecycle.
- Developer Efficiency: Spend less time on infrastructure and more time building core features.
- Resilient by Default: Built-in support for background jobs and secure upload flows.
Next Steps
Installation
Get Better Media running in your project in minutes. View Installation
Basic Usage
Learn how to ingest your first file and save it to storage. View Basic Usage
Explore Adapters
Connect to S3, Postgres, Redis, and more. View Adapters