apiLiveFeatured

FilesHub

com.aoneahsan.fileshub

Files Hub is a self-hosted Laravel 12 platform that combines multi-tenant file storage with 72 developer-utility APIs (218 versioned endpoints) behind one API key โ€” and serves as the canonical upload backend that every other Ahsan/Zaions project sends its files to, replacing paid Firebase Storage.

2024-01 โ†’ PresentZaions

At a glance

Category
api
Status
Live
Started
Jan 2024
Last updated
2 months ago

Identifier

com.aoneahsan.fileshub

Preview

Take a look before you go

The still below is painted first, then the running site loads behind it โ€” so the dialog is never an empty rectangle waiting on a network round trip. Where a site allows framing the live app takes over; where it refuses, the still stays and says so. Nothing is requested until you press.

FilesHub, as its brand card renders

About

What this actually is

Uploads. Transactional email. A PDF, a QR code, a resized image.

Every product needs some of that. Each one arrives as a separate vendor with a separate bill, a separate key and a separate dashboard that nobody ever logs into.

None of them is expensive on its own.

Together they are why a project starts costing money before it has a single user, and why the cost climbs on a curve that has nothing to do with whether anybody is using the thing.

The rule underneath everything on this site is that no paid service sits in the critical path.

Firebase Storage is on the wrong side of that line, so it was ruled out rather than budgeted for. That leaves two honest options: do without file storage and outbound email, or build the platform once and let every project use it.

FilesHub is the second option.

It is a Laravel 12 platform with a Laravel Nova admin panel, exposing 72 features over 181 versioned API routes.

Object storage. Transactional email. Image processing, PDF, QR and barcode generation, URL shortening, and a deep catalogue of developer utilities: hashing, encoding, JWT, conversion, minification, language and spam detection.

One API key reaches all of it, and per-key permissions decide which parts.

Keys carry origin whitelisting and rate limiting, which is what separates a key that may ship inside a browser bundle from one that must never leave a server.

That distinction is the thing integrators get wrong. An origin-restricted key can sit in client code; an unrestricted one cannot. A key listing will not reliably tell you which of the two you are holding, so the only trustworthy answer comes from probing the key itself.

The web surface is Blade and Tailwind, with a public discovery layer of a sitemap, a blog and an RSS feed, and an AEO layer carrying llms.txt, a pricing document, JSON-LD and an allowlist for AI crawlers.

It already runs in production as the upload backend behind the rest of this portfolio.

That is the part worth checking rather than believing. The argument for one self-hosted platform over a stack of single-purpose vendors is not a projection here, because the products depending on it are the ones listed elsewhere on this site.

The first cost is structural.

A platform everything depends on is a single point of failure with a friendly name. One bad hour is every product's bad hour, and there is one person to answer for it.

Per-key permissions are only ever as careful as the person minting the key.

A key holding more permission than its job needs is one leaked bundle away from being the whole platform, and the model can make that avoidable without making it impossible.

72 features is 72 contracts that have to keep holding. A response shape changed carelessly breaks a consumer that will not find out until its next deploy, which may be months later and will not look like my fault.

There is no iOS build. There is no Apple Developer account behind this work either, so nothing here has ever gone to the App Store. For an HTTP API, that limit costs less than it would elsewhere.

Infrastructure is judged on the days nobody thinks about it. The products sitting above this one stopped having a storage question at all.

Worth knowing

  • Dogfooded infrastructure. Files Hub is the canonical upload backend referenced by the workspace's `services-integrations.md` rules โ€” every other Ahsan/Zaions project sends uploads to `https://fileshub.zaions.com/api/v1/objects`, never to Firebase Storage. That dependency is a stronger reliability signal than any vanity metric.
  • One key, 72 capabilities. A single API key with permission flags unlocks storage, email, media processing, and a deep utility catalog โ€” the breadth is the moat versus single-purpose SaaS APIs.
  • Multi-provider email by design. Gmail SMTP / Brevo / Mailtrap with per-account daily caps avoids lock-in and runaway-loop blast radius.
  • Public-visibility-only is a decision, not a gap. Predictable client-side reads with no signed-URL choreography โ€” intentional, and documented as such.
  • AEO-first. Ships `llms.txt`, `llms-full.txt`, `ai.txt`, `pricing.md`, and a full AI-bot allowlist in `robots.txt` so AI search engines and buying agents can read the product without executing JS. JSON-LD graph (Organization, WebSite, SoftwareApplication, FAQPage, HowTo, BreadcrumbList) across pages.
  • Reproducible quality cadence. Both a SEO/AEO pass and a comprehensive codebase audit are gated behind re-run guards (โ‰ฅ3 days + page-touch delta for SEO; 7-day cooldown for the full audit) so audits don't churn the commit log.
  • Database-agnostic. Defaults to SQLite for zero-config dev; production runs MySQL, with `doctrine/dbal` keeping Postgres on the table.
  • Honest backbone over a flashy mobile story. The repo carries Play/App-Store *planning* assets, but no mobile build exists โ€” the portfolio deliberately positions Files Hub as web-app-only rather than implying a shipped app.

Built with

  • Laravel 12
  • Laravel Nova
  • PHP
  • Blade
  • Vite 8
  • TailwindCSS
  • MySQL

Key features

What it does, and what that costs to build

Each of these is a capability the stack genuinely provides. None of them is an outcome nobody measured โ€” there is no "cut onboarding by 40%" on this page, because no one measured onboarding.

  • Multi-tenant object storage (upload/download/delete)
  • 72 features over 181 versioned REST endpoints
  • Multi-provider transactional email
  • Image processing, PDF, QR & barcode generation
  • Per-key permissions, origin whitelisting, rate limiting
  • Canonical upload backend for the whole ecosystem
  • AEO-first discovery layer (llms.txt, pricing.md)

Screenshots

5 slots, 2 of them filled in

These are designed frames, not pictures. Each one records what belongs in the slot and at what width; the capture itself is taken from the running app. Drawing a fake screenshot here would put an image on the site that no build has ever produced.

Timeline

Still being worked on

  1. Jan 2024

    Work started

    The earliest month on record for FilesHub.

  2. Sep 2026

    Last change

    Status is completed โ€” 2 months ago. Ongoing, so this row moves whenever something lands.

Questions

Common questions

The questions that actually arrive, answered in the first sentence.

Who built FilesHub?
Ahsan Mahmood built it alone, and it runs at fileshub.zaions.com. The Laravel platform, the Nova admin panel, the API surface and the key model are one person's work, and it is the backend the other products on this site upload through. Building infrastructure for yourself has one honest advantage: the first person to hit every rough edge is you.
What can a single FilesHub API key do?
As much as its permissions allow and no more. Each key carries its own granular permissions, an origin whitelist and a rate limit. That is what lets one key reach object storage, email, image processing and the utility endpoints without becoming a key that can do anything. Minting a key with more permission than its job needs is the mistake the model exists to make avoidable, and it is still possible.
Is there an iPhone app for FilesHub?
No, and it would not add much โ€” FilesHub is an HTTP API, so anything that can make a request can already use it, an iPhone included. There is no iOS build here in any case, because there is no Apple Developer account behind this work. The web surface is a browser application rather than an installed one.
Why build a file and email platform instead of paying for one?
Because a paid service in the critical path is a dependency whose price somebody else controls, and this whole practice is arranged so that none exists. Firebase Storage sits on the paid side of that line, so it was ruled out rather than budgeted for. One platform doing storage, email, image work and document generation replaces several single-purpose vendors, and the saving is not theoretical here, because it is the arrangement the other products on this site already run on.
What is FilesHub used for today?
It is the upload backend behind the rest of this portfolio, in production rather than in a demo. That is also the strongest thing that can be said about it: the products listed on this site are its live proof, and each of them can be opened and checked. Anything I could add about performance would be a number nobody else can regenerate.

Keep looking

More from the catalogue

  • ZT

    ZTools

    com.zaions.ztools

    A privacy-first developer and power-user toolbox covering 20 categories, where the work happens in your browser rather than on someone's server.

    completedFeatured
  • VI

    Video Controls Plus

    com.aoneahsan.videocontrolsplus

    Playback speed, loops and shortcuts on any HTML5 video. Chrome, Firefox and Edge.

    completedFeatured
  • CL

    ClearHire

    com.aoneahsan.clearhire

    A hiring platform built around one idea: employment claims should be checkable. Resume builder, candidate and company workflows, a verified-employment system, and 50+ career tools.

    completedFeatured
All 23 projects