imgyjs is a framework‑agnostic image storage layer that sits between your application, a storage provider (Vercel Blob, Amazon S3, etc.), and a database (MongoDB, Firebase).

It provides:

• A simple upload API that returns a public image URL
• Pluggable storage and database backends
• Domain‑based read/write permissions
• First‑class integrations for Next.js (App Router) and Express
• Optional scaffolding via create-imgyjs-app to generate a fully wired project

Table of Contents

1. Installation
2. Quick Start
3. Configuration
   • imgy.config.json
   • Environment variables
4. Next.js Usage
   • Server setup
   • Upload route
   • Stats route
   • Client upload example
5. Express Usage
6. Domain Permissions
7. API Reference
8. Scaffolding CLI (Optional)
9. Troubleshooting
10. License

Installation

Install the core library:

npm install imgyjs

OR BY USING IMGY SCAFFOLDING

npx create-imgyjs-app@latest