Fucking File Hosting

A blazing-fast, privacy-first file hosting service built with Laravel 12 and React 18.

Upload and share files instantly with zero registration, complete privacy protection, and enterprise-grade security. Optimized for shared hosting environments with support for files up to 100MB.

✨ Key Features

🚀 Blazing Fast Performance

• Instant file uploads with drag-and-drop interface
• Zero speed limits on downloads
• Chunked uploads for large files (>25MB)
• Memory-efficient streaming
• Sub-1-second page loads

🔒 Complete Privacy Protection

• Zero tracking - No IP logging, user agents, or personal identifiers
• No registration required - Upload files anonymously
• Cryptographically secure URLs - Unguessable download links
• No cookies or analytics - Complete user anonymity
• Privacy-first architecture

📁 Powerful File Management

• Upload files up to 100MB
• Support for all file types with proper MIME detection
• Flexible expiration - 1-365 days or permanent storage
• Automatic cleanup of expired files
• File deduplication to save storage space

🛡️ Enterprise-Grade Security

• Comprehensive file validation (extension, MIME type, content scanning)
• Malware protection with advanced security checks
• Rate limiting with privacy-friendly IP hashing
• Security headers (CSRF, XSS, CSP)
• Secure file storage with protected directories

🔧 Developer-Friendly API

• RESTful API endpoints for programmatic access
• curl integration - Easy command-line uploads
• JSON responses with proper HTTP status codes
• No authentication required - Frictionless API access
• Bulk upload support

📱 Modern User Experience

• Dark theme with orange/red gradient accents
• Fully responsive - Works on all device sizes
• Progressive Web App - Install as native app
• Accessibility compliant - WCAG 2.1 AA standards
• System fonts for fast loading

🚀 Quick Start

Requirements

• PHP 8.2+ with required extensions
• MySQL 5.7+ or SQLite
• Node.js 18+ and npm
• Composer
• Web server (Apache/Nginx)

Installation

1. Clone the repository

   git clone https://github.com/PhyschicWinter9/Fucking-file-hosting.git
   cd fucking-file-hosting

2. Install dependencies

   composer install
   npm install

3. Environment setup

   cp .env.example .env
   php artisan key:generate

4. Database setup

   php artisan migrate

5. Build assets

   npm run build

6. Start development server

   composer run dev

Visit http://localhost:8000 to access your file hosting service!

📚 Documentation

Our documentation is organized in a step-by-step manner for easy navigation:

1. Installation Guide - Complete setup instructions
2. API Documentation - RESTful API reference
3. Project Overview - Features and technical specs
4. Deployment Guide - Production deployment
5. Environment Setup - Development environments
6. Maintenance Mode - Maintenance features
7. Troubleshooting - Common issues and solutions
8. Advanced Configuration - Performance tuning
9. Social Media Guide - Marketing and community
10. Cronjobs and Commands - Automated tasks and monitoring

🛠️ Technology Stack

Backend

• Laravel 12 - Modern PHP framework
• PHP 8.2+ - Latest PHP features
• MySQL/SQLite - Flexible database support
• Inertia.js - SPA without API complexity

Frontend

• React 18 - Modern UI library
• TypeScript - Type-safe development
• Tailwind CSS 4 - Utility-first styling
• Vite - Fast build tool

Features

• Chunked uploads - Large file support
• File deduplication - Storage optimization
• Rate limiting - Abuse prevention
• Automated cleanup - Cronjobs for maintenance
• Performance monitoring - Resource tracking
• Custom commands - System administration
• CDN ready - Global distribution

🔧 API Usage

Upload a file

curl -X POST http://localhost:8000/api/upload \
  -F "file=@example.pdf" \
  -F "expiration_days=30"

Download a file

curl -X GET http://localhost:8000/f/{file_id} \
  -o downloaded-file.pdf

Get file information

curl -X GET http://localhost:8000/api/file/{file_id}/info

🚀 Deployment

Shared Hosting (cPanel)

1. Upload files to public_html
2. Create MySQL database
3. Run setup wizard at /setup
4. Configure environment variables

VPS/Dedicated Server

1. Install PHP 8.2+ and extensions
2. Configure web server
3. Set up database
4. Run deployment commands

Docker

docker-compose up -d

See the Deployment Guide for detailed instructions.

🤝 Contributing

We welcome contributions! This project was built with Kiro AI assistance.

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: php artisan test
5. Submit a pull request

Code Style

• Follow PSR-12 for PHP
• Use Prettier for JavaScript/TypeScript
• Write tests for new features
• Update documentation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Kiro AI - This project was developed with assistance from Kiro, an AI-powered development assistant
• Laravel Community - For the amazing framework
• React Team - For the excellent UI library
• Privacy Advocates - For inspiring privacy-first design
• Open Source Community - For tools and inspiration

🔗 Links

• Documentation: /documentation
• API Reference: API Documentation
• Issues: GitHub Issues
• Discussions: GitHub Discussions

📊 Stats

---

Made with ❤️ and Kiro AI | Privacy First | Open Source"