shrinerb/shrine

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

3285 stars · 277 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Shrine is a modular file attachment toolkit for Ruby applications that handles uploading, storing, processing, and serving files across many storage backends like filesystem, S3, and Google Cloud. It integrates with popular ORMs via plugins and supports direct, presigned, and resumable uploads with background processing.

Use cases

• attach images to models in a Ruby app
• upload files to S3 from a Rails application
• generate image thumbnails on upload
• handle large resumable file uploads
• accept direct-to-cloud uploads from the browser
• store attachments with ActiveRecord or Sequel
• process uploads in background jobs

When to choose

• you need framework-agnostic file attachments in Ruby (Sinatra, Roda, Hanami, Rails)
• you want pluggable storage backends and a modular plugin system
• you need direct or resumable uploads with Uppy or tus
• you want eager or on-the-fly thumbnail generation

When to avoid

• you're not using Ruby
• you need a simple one-file upload in a non-web script
• you want a batteries-included Rails-only solution like Active Storage

Facets

library · maturity stable

file-upload image-processing orm middleware plugin-system web-development backend files developer-tools ruby cross-platform file-attachments s3 direct-upload resumable-uploads activerecord sequel rack background-jobs thumbnails web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="shrinerb/shrine")