Skip to content

sergix44/xbackbone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,072 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XBackBone

License

XBackBone is a simple, self-hosted, lightweight file and media sharing platform with first-class ShareX support. Upload images, GIFs, video, audio, PDFs, code and arbitrary files, then share them through clean short links with rich social embeds. It ships with a modern web UI, multi-user management, a versioned REST API, and pluggable storage backends.

This is the next-generation XBackBone, rebuilt from the ground up on Laravel 13 and Livewire 4.

Features

  • ShareX ready — generate a ready-to-use ShareX uploader config in one click.
  • Wide media support — inline previews for images, video, audio (waveform), PDFs, and syntax-highlighted code, plus pastes and link shortening.
  • Multiple storage backends — Local disk, Amazon S3 (and S3-compatible), FTP, and SFTP.
  • Content-addressed storage — uploads are de-duplicated by content fingerprint.
  • Private & public uploads — per-resource visibility, optional password protection and expiration.
  • REST API — versioned API with token authentication and auto-generated OpenAPI docs.
  • Modern authentication — registration, email verification, password reset, and passkeys (WebAuthn).
  • User management — admin roles, per-user disk quotas, and usage statistics.
  • Feature flags — toggle sign-ups, default theme and more without redeploying.
  • Theming — switchable daisyUI themes, localization-ready UI.
  • Guided web installer — set up the database, storage, and admin account from the browser.
  • Legacy import — migrate users and uploads from a legacy XBackBone instance, with old links transparently redirected.

Architecture

This repository is a monorepo composed of two parts:

Directory Description
core/ The full XBackBone application — a Laravel + Livewire app that implements all the logic. It is published as the xbackbone/core Composer package.
app/ A minimal installation skeleton (config, bootstrap and public entrypoint) that pulls xbackbone/core in as a Composer dependency.

The skeleton boots the core package and remaps its public, storage and environment paths to the skeleton root. Keeping the application logic in a versioned package means an instance can be upgraded or downgraded by simply changing the required version of xbackbone/core, without touching the rest of the deployment.

See core/README.md for the application's technical details and the development setup.

Getting started

Full installation, configuration and usage instructions are available in the documentation.

Documentation

XBackBone Documentation

Contributing

Contributions are welcome! Please read the Code of Conduct before opening an issue or pull request.

Security

If you discover a security vulnerability within XBackBone, please email sergio@brighenti.me instead of using the public issue tracker. See SECURITY.md for details. All reports are addressed promptly.

License

XBackBone is open-source software licensed under the Apache License 2.0.