A self-contained platform for hosting images and static assets generated from CI/CD pipelines. View build artifacts like screenshots, test reports, and other generated assets through an intuitive web interface.
- Easy Asset Upload - GitHub Action for seamless artifact uploads from CI/CD
- Web-Based Viewing - Browse and view assets through a beautiful interface
- Self-Contained Deployment - Single Docker Compose deployment for any cloud
- Flexible Storage - Support for Local, MinIO, S3, GCS, and Azure Blob Storage
- Secure Access - Authentication and authorization for asset management
Full documentation is available at docs.bffless.app.
| Section | Topics |
|---|---|
| Getting Started | Quickstart, Cloudflare Setup, Let's Encrypt Setup, Setup Wizard, First Deployment, Viewing Deployments |
| Features | Traffic Splitting, Share Links, Proxy Rules, Authorization, Repository Overview |
| Deployment | Overview, DigitalOcean, SSL Certificates, GitHub Actions |
| Configuration | Environment Variables, Storage Backends, Authentication |
| Storage | AWS S3, Google Cloud Storage, Azure Blob Storage, MinIO, Caching, Migration Guide |
| Reference | API, Architecture, Database Schema, Security |
| Troubleshooting | Common issues and solutions |
Backend: NestJS, TypeScript, PostgreSQL, Drizzle ORM, SuperTokens
Frontend: React, TypeScript, Vite, Redux Toolkit, TailwindCSS, Radix UI
Infrastructure: Docker, Nginx, MinIO
Upload artifacts from your CI/CD pipeline:
- uses: bffless/upload-artifact@v1
with:
path: dist
api-url: ${{ vars.ASSET_HOST_URL }}
api-key: ${{ secrets.ASSET_HOST_KEY }}Only 3 required inputs - repository, commit SHA, and branch are auto-detected from GitHub context.
Join our Discord for support, feature discussions, and updates.
Contributions welcome! See CONTRIBUTING.md for guidelines.
Built by Toshimoto
O'Saasy License - see LICENSE for details.
Documentation | Discord | Changelog | Issues