Image Hosting Platform

A full-stack image hosting and sharing platform built for authenticated users to upload, organize, and distribute images through public pages and album galleries.

The application uses a direct-to-storage architecture with Cloudflare R2, allowing image uploads to bypass the application server entirely. This approach reduces server load, improves scalability, and enables efficient handling of large image libraries.

Key Features

Direct Cloudflare R2 Uploads

• Browser-to-R2 uploads using presigned URLs
• Server never processes image binaries directly
• Reduced bandwidth and infrastructure costs
• Secure upload validation and metadata tracking

Image Library Management

• Personal image dashboard
• Image metadata and storage information
• Visibility controls (Public / Unlisted)
• Image detail pages with shareable URLs

Album System

• Create and manage image collections
• Public and unlisted album visibility
• Gallery-style browsing experience
• Shareable album links

Public Sharing

• Dedicated public image pages
• Direct CDN image URLs
• Copy-ready Markdown, HTML, and BBCode embeds
• Easy integration with forums, blogs, and websites

Administration Dashboard

• Upload pipeline monitoring
• Storage usage analytics
• Upload status tracking
• Operational overview of image infrastructure

Authentication & Access Control

• User authentication powered by Clerk
• Protected dashboard routes
• Role-based administration access
• Secure ownership validation

Technical Challenges

Scalable Upload Architecture

Instead of routing image uploads through the application server, the platform generates presigned upload URLs and allows clients to upload directly to Cloudflare R2. This significantly reduces server workload while maintaining security and ownership verification.

Public Sharing Without Exposing Internal Resources

The application separates storage infrastructure from public-facing URLs, enabling controlled image sharing while maintaining access management and metadata ownership within the platform.

Consistent Content Management

Images, albums, visibility settings, and upload states are synchronized through a relational database model using Drizzle ORM and PostgreSQL, ensuring reliable content organization and retrieval.

Results

The project evolved into a production-ready image hosting solution featuring authenticated uploads, album management, public sharing workflows, and operational monitoring. It demonstrates full-stack architecture design, cloud storage integration, authentication, database modeling, and scalable file delivery patterns.