case study
using bb.bi as an image CDN
permanent short URLs for every image you need to share
the problem
you need to host images somewhere — for a README, a blog post, social media, documentation, or just to share with someone. the usual options are frustrating:
- imgur gives you random hashes like i.imgur.com/aB3cDeF.png
- GitHub issue uploads are long, ugly, and tied to a repo
- cloud storage (S3, R2) requires setup, config, and often a credit card
- most services can delete your images or change URLs without notice
what you really want is a permanent, short, human-readable URL that you control.
the solution
bb.bi's media library plugin turns your handle into a personal image CDN. upload any image, give it a custom slug, and get a clean permanent URL:
studio.bb.bi/m/logo studio.bb.bi/m/og-image studio.bb.bi/m/screenshot-v2 studio.bb.bi/m/team/alice
every URL is short, readable, and yours. no random hashes. no expiration. no surprise deletions.
what you need
plan
free (100 MB) — upgrade for more
plugin
media library
storage
100 MB (free) · 1 GB (pro) · 5 GB (max) · 10 GB (business)
how to set it up
1. claim a handle
sign up at bb.bi and claim a handle. for an image CDN use case, something like studio, assets, media works well.
2. upgrade to pro (or higher)
the media library plugin requires a pro plan or above. plans start at $9.99/year and include 1 GB of storage (5 GB on max, 10 GB on business).
3. enable the media library plugin
go to your handle's dashboard → plugins → enable media library. this unlocks image uploads and the /m/ URL namespace.
4. upload and organize
upload images directly from the dashboard. for each image:
- custom slug — choose a clean, descriptive name (logo, hero-dark, screenshot-v3)
- folders — organize by project or category (team/alice, blog/post-1)
- alt text — add descriptions for accessibility
5. use your URLs anywhere
once uploaded, your images are available at their permanent URLs. use them in:
<!-- markdown -->  <!-- html --> <img src="https://studio.bb.bi/m/og-image" alt="OG image" /> <!-- GitHub README --> 
why this works
permanent URLs
your image URLs never change and never expire. studio.bb.bi/m/logo will always point to your logo. if you update the image, the URL stays the same.
human-readable
compare studio.bb.bi/m/logo to i.imgur.com/aB3cDeF.png . you can read the URL and know what it points to. you can type it from memory. you can put it on a slide.
organized
folders and custom slugs mean your image library stays clean as it grows. no more scrolling through hundreds of timestamped filenames.
fast
images are served from Cloudflare's global CDN with proper cache headers. your images load fast everywhere in the world.
affordable
the media library requires a pro plan — $9.99/year with 1 GB storage. that's less than a dollar a month for your own image CDN with custom URLs. higher plans get up to 10 GB.
example: a developer's image library
say you're a developer who needs images for READMEs, blog posts, and documentation. you claim dev as your handle and set up your subdomain at dev.bb.bi.
dev.bb.bi/m/avatar → your profile photo dev.bb.bi/m/projects/app → app screenshot dev.bb.bi/m/projects/cli → CLI demo dev.bb.bi/m/blog/post-1 → blog post hero image dev.bb.bi/m/og → default OG image
every README, every blog post, every social share — all pointing to clean, permanent URLs you control. update an image once, it updates everywhere.
ready to set up your image CDN?
claim a handle, enable the media library, and start uploading. takes about 30 seconds.