Introduction

Welcome to Dropper documentation! Dropper is a developer-friendly file management platform that makes it easy to add file upload, storage, and delivery capabilities to your applications.

What is Dropper?

Dropper provides a complete file management solution with:

  • Simple Integration - Add file uploads to your app in minutes
  • Multiple Storage Providers - Support for AWS S3, Azure Blob, Google Cloud, Cloudflare R2, and more
  • Framework Agnostic - Works with React, Vue, Angular, and vanilla JavaScript
  • Type-Safe - Full TypeScript support
  • Production Ready - Built for scale with enterprise features

Quick Example

Here's how easy it is to add file uploads to your React app:

import { DropperProvider, FileUpload } from '@dropper/react'

function App() {
  return (
    <DropperProvider publishableKey="pk_dropper_test_xxx">
      <FileUpload
        onSuccess={(file) => console.log('Uploaded:', file.url)}
        accept="image/*,video/*"
        maxSize="10MB"
      />
    </DropperProvider>
  )
}

Core Packages

Dropper is built with a modular architecture:

@dropper/core

The framework-agnostic core library that powers all Dropper integrations. Use it directly in Node.js, vanilla JavaScript, or as a foundation for framework-specific packages.

Learn more about @dropper/core →

@dropper/react

React components and hooks for building file upload interfaces. Includes drag-and-drop, progress tracking, and file management components.

Learn more about @dropper/react →

Coming Soon

  • @dropper/vue - Vue composables and components
  • @dropper/angular - Angular services and directives
  • @dropper/mobile - React Native components

Key Features

File Upload

Upload files with progress tracking, retry logic, and concurrent upload support. Handle single files or batch uploads with ease.

File Management

List, search, filter, and organize files. Create folders, move files, and manage your entire file hierarchy through a simple API.

Storage Flexibility

Choose your storage provider - AWS S3, Azure Blob Storage, Google Cloud Storage, Cloudflare R2, DigitalOcean Spaces, or Backblaze B2. Switch providers anytime without changing your code.

Security

Built-in security with signed URLs, access control, and encryption. GDPR compliant and SOC 2 ready.

Developer Experience

  • Full TypeScript support
  • Comprehensive documentation
  • Code examples for every feature
  • Active community support

Getting Started

Ready to get started? Follow our Quick Start Guide to add Dropper to your project in under 5 minutes.

Or jump straight to the package documentation:

Need Help?