ActiveStorage-like file storage for Phoenix.

Storage provides a unified interface for handling file uploads in Phoenix applications, supporting multiple storage backends and following the design principles of Rails ActiveStorage.

Features

• Multiple storage backends (local filesystem, S3, etc.)
• Direct uploads with signed URLs
• Image processing and variants
• Ecto schema integration
• Phoenix LiveView support
• Configurable storage services

Configuration

Add to your config.exs:

config :storage,
  default_service: :local,
  services: %{
    local: {Storage.Services.Local, root: "/tmp/storage"},
    s3: {Storage.Services.S3, bucket: "my-bucket", region: "us-east-1"}
  }

Usage

In your schema

defmodule MyApp.User do
  use Ecto.Schema
  use Storage.Attachment

  schema "users" do
    field :name, :string
    has_one_attached :avatar
    has_many_attached :documents
  end
end

In your LiveView

def handle_event("save", %{"user" => user_params}, socket) do
  uploaded_files =
    consume_uploaded_entries(socket, :avatar, fn %{path: path}, entry ->
      {:ok, Storage.put_file(path, filename: entry.client_name)}
    end)

  # Use uploaded_files...
end