Skip to content
FDCase studySaaS · Document ToolsLive

FilesMint — Document Conversion SaaS

Gives everyday PDF and image jobs a paid, quota-backed home where file bytes never touch the API.

A PDF and image toolkit — merge, split, convert, compress, watermark and protect — built as a job queue where file bytes never pass through the API, with Stripe billing, per-plan quotas and a statically-rendered page per tool for SEO.

FilesMint — Document Conversion SaaS interface
Industry
Consumer SaaS / Productivity
Role
Architect & Full-Stack Engineer
Type
SaaS Platform
Year
2025

01

Overview

FilesMint is a document-conversion SaaS with 13 tools across organize, convert, optimize and secure. The architecture follows one principle: file bytes never flow through the API. The browser gets presigned upload URLs, puts files directly into object storage, and the API only ever moves small JSON — enqueueing a Celery job that the worker picks up.

That constraint keeps the API cheap and horizontally scalable regardless of file size, and it is what makes the free tier viable. Anonymous users are rate-limited per IP through Redis; signed-in users get daily quotas per plan tracked in Postgres, with Stripe handling the Pro subscription and webhooks mirroring subscription state back into the database.

Compression is deliberately Ghostscript-free — pikepdf and Pillow instead — so the whole stack stays license-safe for commercial use.

02

Business challenge

Document-conversion sites either push every uploaded file through their API — which makes cost scale with file size and blocks the request thread — or they run conversions with Ghostscript, whose licensing is a problem for a commercial product.

03

Solution

A job queue with a web front end. The browser uploads straight to object storage via presigned URLs, the API enqueues a small JSON job, and Celery workers do the conversion. Compression is implemented on pikepdf and Pillow so no Ghostscript licence is involved.

What it does

13 tools across organize, convert, optimize and secure
Presigned direct-to-storage uploads — no file bytes through the API
Celery job queue on a Redis broker
Supabase magic-link authentication
Stripe subscriptions with checkout, portal and webhook mirroring
Per-plan daily quotas in Postgres, per-IP limits in Redis for anonymous use
Account dashboard with usage bar and re-downloadable history
A statically-rendered landing page per tool for SEO
JSON-LD structured data, per-tool OG images, sitemap and manifest
License-safe compression — pikepdf and Pillow, no Ghostscript

04

Product screenshots

Screens from the application itself. Select any image to view it full size.

05

Architecture

How it fits together

  1. 01Next.js App Router front end with a statically-rendered page per tool for SEO
  2. 02FastAPI service issuing presigned upload URLs and enqueueing jobs — never handling file bytes
  3. 03Celery workers on a Redis broker running the conversion engines
  4. 04Supabase Postgres for users, jobs, billing and usage; Supabase Auth for magic-link sign-in
  5. 05Stripe checkout, customer portal and webhooks mirroring subscription state into the database
  6. 06Two-tier rate limiting — per-user daily quotas in Postgres, per-IP limits in Redis for anonymous users

06

Engineering challenges

Challenge
Letting anonymous users convert files for free invites abuse, but forcing sign-up before the first conversion kills the funnel.
How it was solved
Split rate limiting by identity: anonymous traffic is limited per IP through Redis, signed-in users get daily quotas per plan tracked in Postgres. The free tier stays genuinely usable without an account while the abuse ceiling stays low.
Challenge
PDF compression conventionally means Ghostscript, whose licence terms are unworkable for a commercial SaaS.
How it was solved
Rebuilt compression on pikepdf and Pillow — image downsampling plus object-stream optimization — keeping the entire toolchain license-safe at the cost of writing the size/quality trade-off logic directly.

07

Technology stack

Frontend
Next.jsTailwind CSS
Backend
FastAPIPythonCelery
Data
RedisPostgreSQL
Infrastructure
pikepdf
Also used
SupabaseStripeGotenberg

08

Business impact

13
Tools
21 passing
Backend Tests
Job queue
Architecture

A conversion SaaS where infrastructure cost is decoupled from file size, the free tier works without an account, and every tool has its own crawlable landing page with structured data — backed by 21 passing backend unit tests.

09

Project status

Live2025

What I took from it

  • Deciding early that "file bytes never touch the API" removes an entire class of scaling and timeout problems later.
  • Licence terms are an architectural constraint: checking them before picking an engine is cheaper than replacing it after launch.

Next step

Need a similar solution for your business?

Tell me what you are trying to build or fix. I will come back with how I would approach it, what it realistically takes and where the risks are.

Related work

All projects