Skip to main content
Framalab is a photographer management platform. The SDK is the public-facing layer — it wraps the Gallery API and lets you build your gallery frontend in any stack.
The panel is where the photographer curates work. The gallery is whatever you build with this SDK.

​
How it works

1

Photographer curates

The photographer uploads photos and marks approved ones in the Framalab panel.
2

Gallery API exposes them

Approved photos become available through the Gallery API, authenticated with a token.
3

You build the frontend

Use the SDK to fetch photos, collections, and metadata. Render however you want.

​
What you can do

  • Fetch project metadata (name, type, status)
  • List all approved photos with their pre-generated WebP versions
  • Browse photo collections
  • Generate transformed image URLs (resize, format, quality)

​
What this SDK is NOT

  • It does not handle client proofing or selections — that’s the client panel
  • It does not upload or manage photos — that’s the admin panel
  • It has no UI components — you own the rendering

​
Package

@dcmx-studio/framalab-sdk ships with zero runtime dependencies. It uses native fetch and is fully typed with TypeScript. 
import { createFramalabClient } from "@dcmx-studio/framalab-sdk"

​
Next steps

Quickstart

Fetch your first photo in under 5 minutes

Authentication

Understand gallery tokens