📁 FileShare Pro

A modern, secure, and user-friendly file sharing platform built with Flask

---

✨ Features

🔐 User Management

• Secure Authentication - User registration and login with password hashing
• Email Verification - Verify email addresses to ensure legitimate users
• Password Recovery - Reset forgotten passwords via email
• Profile Management - Customizable user profiles with avatar support
• Admin Dashboard - Comprehensive admin controls for user and system management

📤 File Sharing

• Easy Upload - Drag-and-drop or click to upload files
• File Bundles - Share multiple files with a single link
• Quick Share Links - Generate shareable links instantly
• File Preview - Preview images and common file types
• Download Tracking - Monitor file access and downloads
• Expiration Control - Set automatic file deletion after a period

🎨 Modern Interface

• Responsive Design - Works seamlessly on desktop, tablet, and mobile
• Progressive Web App (PWA) - Install as a native app on any device
• Dark Mode Ready - Eye-friendly interface
• Intuitive UI - Clean and simple user experience

⚙️ Administration

• Storage Management - Configure user and server storage limits
• User Controls - Manage user accounts and permissions
• Email Configuration - Set up SMTP for notifications
• System Settings - Customize app name, file size limits, and more

---

� Screenshots

🔐 Login & Registration

Secure login with account recovery

Easy account creation

📤 File Sharing

Drag & drop file upload

User profile with storage stats

⚙️ Admin Dashboard

System analytics

Configuration panel

User management

🔄 Account Recovery

Password reset and account recovery

---

�🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• pip (Python package installer)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/fileshare.git
   cd fileshare

2. Install dependencies

   pip install -r requirements.txt

3. Configure settings (Optional)

   cp settings.example.json settings.json
   # Edit settings.json with your configuration

4. Run the application

   python flask_app.py

5. Access the app

   Open your browser and navigate to http://localhost:5000

---

📋 Configuration

Email Setup (Optional)

To enable email features (verification, password reset), create a settings.json file:

{
  "app_name": "FileShare Pro",
  "registration_open": true,
  "max_file_size_mb": 40,
  "max_files_per_bundle": 5,
  "user_storage_limit_mb": 50,
  "total_server_storage_mb": 500,
  "email": {
    "MAIL_SERVER": "smtp.gmail.com",
    "MAIL_PORT": 587,
    "MAIL_USE_TLS": true,
    "MAIL_USERNAME": "your-email@gmail.com",
    "MAIL_PASSWORD": "your-app-password",
    "MAIL_DEFAULT_SENDER": "your-email@gmail.com"
  }
}

Storage Limits

You can configure storage limits in settings.json:

• max_file_size_mb - Maximum size per file upload
• user_storage_limit_mb - Storage quota per user
• total_server_storage_mb - Total server storage limit

---

🛠️ Technology Stack

Technology	Purpose
Flask	Web framework
Flask-Session	Server-side session management
Flask-Mail	Email functionality
Pillow	Image processing
Werkzeug	Security utilities

---

📁 Project Structure

FileShare/
├── flask_app.py              # Main application file
├── requirements.txt          # Python dependencies
├── settings.json             # App configuration (create from example)
├── settings.example.json     # Example settings file
├── generate_icons.py         # PWA icon generator
├── static/
│   ├── manifest.json         # PWA manifest
│   ├── service-worker.js     # Service worker for PWA
│   └── icons/                # App icons
├── templates/                # HTML templates
│   ├── index.html           # Main upload page
│   ├── login.html           # Login page
│   ├── register.html        # Registration page
│   ├── profile.html         # User profile
│   ├── admin_dashboard.html # Admin panel
│   └── ...
├── uploads/                  # User uploaded files (auto-created)
├── profile_pictures/         # User avatars (auto-created)
└── flask_session/           # Session data (auto-created)

---

🔒 Security Features

• Password Hashing - Secure password storage
• Session Management - Server-side sessions with expiration
• CSRF Protection - Prevent cross-site request forgery
• File Validation - Sanitize uploaded files
• Email Verification - Confirm user identities
• Secure Tokens - Time-limited tokens for password reset

---

🎯 Usage

Upload Files

1. Log in or register an account
2. Click "Choose Files" or drag files to the upload area
3. Set expiration time (optional)
4. Click "Upload"
5. Share the generated link

Create File Bundles

1. Upload multiple files
2. Select files to bundle
3. Generate a bundle link
4. Share with recipients

Admin Functions

• Access admin dashboard at /admin
• Manage users and their storage
• Configure system settings
• Monitor file uploads and storage usage

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📝 License

This project is licensed under the GNU GENERAL PUBLIC License - see the LICENSE file for details.

---

📧 Support

If you encounter any issues or have questions, please:

• Open an issue on GitHub
• Check existing issues for solutions
• Review the documentation

---

🌟 Acknowledgments

• Built with Flask
• Icons from custom SVG designs
• Inspired by modern file sharing platforms

---

Report Bug