FiloraFS-Lite

A minimal Spring Boot foundation for local file uploads, downloads, and management with API-key protection.

Website · Documentation · Changelog

Included

• Local filesystem storage with generated filenames
• Upload, download, list, metadata, and delete APIs
• File-type validation and path containment checks
• Shared API-key protection
• Browser API tester, Postman collection, and automated tests
• Spring Boot health endpoint and graceful shutdown

Quick start

Requires Java 25 LTS and Git. Maven is included through the wrapper.

git clone https://github.com/buildbasekit/FiloraFS-Lite.git
cd FiloraFS-Lite
./mvnw spring-boot:run

Open localhost:8080/api-test. Runs with local storage and a development-only API key; no .env file or external service is required. On Windows, use .\mvnw.cmd.

Replace the development key before deployment; see security boundaries.

→ Quickstart guide

Documentation

Detailed product documentation lives on BuildBaseKit:

• Overview
• Configuration
• API reference
• Architecture

Project context

• AGENTS.md
• AI_RULES.md
• ARCHITECTURE.md
• CONTRIBUTING.md
• SECURITY.md

BuildBaseKit

Part of BuildBaseKit: focused Spring Boot foundations. Lite suits learning, prototypes, internal tools, and simple self-hosted applications.

License

MIT.