ImageKit Media Management

LearnWay uses ImageKit for cloud-based media storage, dynamic on-the-fly transformations, automatic WebP optimization, and fast global CDN distribution.

1. Uploading Images (Admin / User)

Endpoints accepting media (such as avatar uploads or course covers) support multipart/form-data:

POST /api/v2/user/profile-image
Authorization: Bearer <token>
Content-Type: multipart/form-data

file: [Binary Image Data]

Server Upload Flow

The FileInterceptor validates image MIME type and maximum payload size (5 MB).
The MediaModule uploads the file directly to ImageKit into dedicated folder hierarchies:
- /avatars/
- /courses/
- /certificates/
Returns fileId, url, and thumbnailUrl.

2. Dynamic Image Transformations

You can append ImageKit URL query transformations for responsive client performance:

https://ik.imagekit.io/learnway/courses/cover.png?tr=w-400,h-250,fo-auto,q-80