FiloraFS-Pro

A production-ready file storage backend with JWT authentication and S3 support.

Get FiloraFS-Pro

Introduction

FiloraFS-Pro is a developer-friendly Spring Boot boilerplate designed for building secure and scalable file storage systems. It includes JWT authentication, file upload/download APIs, automatic thumbnail generation, and support for both AWS S3 and local storage.

Instead of building complex file infrastructure from scratch, FiloraFS-Pro provides a production-ready backend foundation for your next SaaS or content platform.

Who is this for?

  • • SaaS builders and indie hackers
  • • Backend developers using Spring Boot
  • • Content Platforms & Media Apps
  • • Developers Tired of Rebuilding File Systems

Why Choose FiloraFS-Pro for File Storage?

Save Development Time

Skip weeks of infrastructure setup. FiloraFS-Pro provides a complete file storage API immediately.

Production-Ready Foundation

Security, validation, storage fallback, and optimized API endpoints are already implemented.

Spring Boot Best Practices

Built with clean architecture, structured codebase, and consistent error handling for developers.

Fully Featured Backend

Includes JWT authentication, file management APIs, thumbnails, and S3 integration.

Why not build it from scratch?

Without FiloraFS-Pro

  • ❌ Days or weeks of setup
  • ❌ Complex file handling logic
  • ❌ S3 integration challenges
  • ❌ Security & validation risks
  • ❌ Repeated effort across projects

With FiloraFS-Pro

  • ✅ Ready in minutes
  • ✅ Clean, structured backend
  • ✅ Built-in S3 + local storage
  • ✅ Secure authentication & access control
  • ✅ Production-ready foundation

Key Features

  • JWT Authentication

    Secure login, registration, and role-based authorization for file access.

  • File Upload & Download APIs

    Efficiently upload, retrieve, and stream files through REST endpoints.

  • Automatic Thumbnail Generation

    Built-in support for generating image previews automatically.

  • S3 + Local Storage Support

    Flexible storage options with AWS S3 integration and local fallback.

  • File Management Tools

    List files, retrieve metadata, delete files, and generate pre-signed URLs.

  • Postman Collection

    Includes a pre-configured collection to test all APIs instantly.

Project Structure

src/main/java/com/filorafs/
├── config/        # App configurations
├── controller/    # REST API endpoints
├── dto/           # Data Transfer Objects
├── entity/        # Database models
├── exception/     # Global error handling
├── repository/    # Database access
├── security/      # JWT & Auth logic
├── service/       # Business logic
└── util/          # Helper classes

Quick Start

Step 1

Download the FiloraFS-Pro starter kit from Gumroad.

Step 2

Extract the ZIP file to your local development environment.

Step 3

Open the project in your IDE (IntelliJ, Eclipse, or VS Code).

Step 4

Configure DB, JWT and Storage in application.properties.

Step 5

Run as spring boot app.

API Reference

FiloraFS-Pro provides a complete REST API for authentication, user management, and file operations. Below are the available endpoints.

Authentication APIs
POST /api/auth/login

Authenticate user and receive access & refresh tokens.

POST /api/auth/register

Register a new user account.

POST /api/auth/refresh

Generate a new access token using refresh token.

POST /api/auth/logout

Logout user and invalidate refresh token.

User APIs
GET /api/users/me

Get current authenticated user details.

GET /api/users/profile

Get user profile information.

GET /api/users/all Admin

Retrieve all users (admin only).

GET /api/users/admin-only Admin

Admin-restricted endpoint.

GET /api/users/restricted

Restricted access endpoint for authorized users.

File Management APIs
POST /file

Upload file (multipart form-data). Returns unique file ID/name.

GET /file/{id}

Fetch and stream file.

GET /file/stream/{id}

Stream file for media usage.

GET /file/download/{id}

Download file with proper headers.

DELETE /file/{id}

Delete file permanently.

GET /file/list

List all stored files.

GET /file/info/{id}

Get file metadata (size, type, timestamps).

POST /file/generate-pre-signed-url

Generate temporary access URL with expiration.

GET /file/thumbnail/{id}

Retrieve file thumbnail.

Includes a ready-to-use Postman collection for testing all endpoints.

Ready to Launch Your Storage SaaS?

Get the full FiloraFS-Pro source code and start building your production-grade file management system today.

Buy on Gumroad Explore More Boilerplates