How nauvalunesa/cloudshare works
CloudShare is a zero-knowledge file-sharing platform with a browser-facing dashboard and several adjacent sharing tools. The primary workflow is client-side encryption, upload and storage of encrypted files, then retrieval and client-side verification/decryption. The application is largely implemented in two monolithic FastAPI files: main.py is the documented default, while main_storagebox.py is a storagebox variant. The README documents several capabilities whose implementation details are not shown in the excerpts, so those links are documented relationships rather than inspected call paths.
Main entry points: main.py Sharing API · index.html Client Encryption · drive.html Drive Dashboard · filemanager.html File Manager
Components 17
Encrypted Sharing
- Sharing API
main.py - Client Encryption
index.html - Encrypted File Storage
storage - Storagebox Variant
main_storagebox.py
Drive Management
- Drive Dashboard
drive.html - File Manager
filemanager.html - Server Filesystem
- Login
login.html
Sharing Tools
- URL Shortener
main.py - Bio Links
main.py - Bio Link Viewer
biolink_viewer.html - Code Snippets
main.py - Snippet Viewer
snippet_viewer.html
Server Operations
- SFTP Manager
sftpmanager.html - SFTP Operations
main.py - SFTP Server
Other components
- User
Connections 20
- User → Client Encryption: selects files
README.md - Client Encryption → Sharing API: uploads encrypted data
README.md - Sharing API → Encrypted File Storage: stores ciphertext
README.md - Sharing API → Client Encryption: provides encrypted download
README.md - User → Login: signs in
README.md - Login → Sharing API: authenticates
main.py - User → Drive Dashboard: manages files
README.md - Drive Dashboard → Sharing API: requests file actions
README.md - User → File Manager: browses server files
README.md - File Manager → Sharing API: requests file operations
README.md - Sharing API → Server Filesystem: browses or modifies
README.md - User → URL Shortener: creates short links
README.md - User → Bio Links: creates bio page
README.md - Bio Links → Bio Link Viewer: serves page data
main.py - User → Code Snippets: shares code
README.md - Code Snippets → Snippet Viewer: serves viewer
main.py - User → SFTP Manager: manages remote files
README.md - SFTP Manager → SFTP Operations: requests transfers
README.md - SFTP Operations → SFTP Server: transfers files
main.py - Sharing API → Storagebox Variant: alternative deployment
main_storagebox.py