haydenbleasel/files-sdk

The gap in what exists

There's a gap for a truly minimal, web-standards focused SDK that prioritizes developer experience and avoids the bloat of official cloud SDKs, especially for indie and small team use cases.

Wedge to win

Target indie hackers and small agencies building new projects who want to defer storage provider decisions or need to support multiple environments easily, offering a simpler, more portable API.

Reputation value (worth doing free for proof) — 70/100

Contributing a well-architected, highly-starred open-source utility like this builds strong developer credibility for future dev-tool or agency work.

Likely monetization

unclear

Incumbents to beat

AWS SDK for JavaScriptGoogle Cloud Storage Node.js ClientCloudflare R2 APIVercel Blob SDK

You are an expert full-stack developer. I need you to build a proof-of-concept for a unified storage SDK similar to `files-sdk`. The goal is to provide a single, minimal JavaScript API for common file operations (upload, download, delete, list). Focus on web-standard I/O, particularly using `Blob` and `ReadableStream` where appropriate. Use Next.js 16 App Router, React 19, Tailwind v4, and Node.js for server-side logic. The MVP should support two storage backends: AWS S3 and Vercel Blob. 

Here's the plan:

1.  **Define the Core Interface:** Create a TypeScript interface for `StorageAdapter` with methods like `upload(path: string, file: Blob | ReadableStream, options?: object): Promise<string (URL)>`, `download(path: string): Promise<ReadableStream>`, `delete(path: string): Promise<void>`, and `list(prefix?: string): Promise<string[] (paths)>`.
2.  **Implement S3 Adapter:** Create `S3Adapter` implementing `StorageAdapter` using the `@aws-sdk/client-s3` package. Focus on `PutObjectCommand`, `GetObjectCommand`, `DeleteObjectCommand`, and `ListObjectsV2Command`.
3.  **Implement Vercel Blob Adapter:** Create `VercelBlobAdapter` implementing `StorageAdapter` using the `@vercel/blob` package. Use `put`, `del`, and `list` methods.
4.  **Create a Unified Client:** Build a `StorageClient` class that takes an `StorageAdapter` instance in its constructor and exposes the core methods.
5.  **Develop a Next.js Demo:** Create a simple Next.js page (`/app/page.tsx`) with two forms: one for uploading a file (to either S3 or Vercel Blob, selected via a dropdown) and another to list and download/delete files. Ensure client-side file selection and server-side processing for storage operations. Do not worry about persistent configuration; hardcode API keys/secrets for the demo (clearly marked).
6.  **Build/Verify Gate:** The application should successfully upload a file to both S3 and Vercel Blob, list files from both, and successfully download and delete files. Provide instructions on how to set up AWS S3 and Vercel Blob for testing.