starry-files

byAditya Solanki

PRODUCT REQUIREMENTS DOCUMENT (PRD) Project Name: NexusVault (Centralized File Management Hub) Version: 1.0.0 Author: Aditya Kumar Solanki Status: Draft / Development Ready 1. PROJECT OVERVIEW NexusVault is a sophisticated, single-file web-based utility designed to store, manage, and control various file formats. The tool addresses the problem of fragmented file storage by providing a centralized dashboard to preview, share, and download documents, media, code, and executable files within a "Vibe Coding" workflow. 2. TARGET TECHNOLOGY STACK - Frontend: HTML5, CSS3 (Modern Glassmorphism UI) - Logic: JavaScript (ES6+) - Architecture: Single-file Deployment (All-in-one index.html) - Storage: Browser-based IndexedDB (for persistent local storage without a backend) 3. SUPPORTED FILE FORMATS - Documents: .pdf, .docx, .doc, .txt - Images: .jpg, .jpeg, .png, .gif, .svg - Audio: .mp3, .wav, .aac - Video: .mp4 - Code/Data: .html, .css, .js, .py, .java, .json, .xml, .php - Archives/Executables: .exe, .dmg, .app, .zip, .7z, .tar, .gz 4. KEY FEATURES & FUNCTIONALITIES 4.1 File Upload & Storage - Drag-and-drop interface for all supported formats. - Batch upload capability. - Metadata extraction (File name, size, type, upload date). 4.2 File Management Dashboard - Grid/List view toggle. - Category-based filtering (Media, Docs, Code, Others). - Search bar for real-time file name filtering. - File count and storage capacity tracker. 4.3 Smart Viewer Engine (The "Open" Feature) - Integrated Media Player: Native player for mp4, mp3, wav. - Syntax Highlighter: Code previewer for .js, .py, .html, etc. - PDF/Text Viewer: Inline reader for documents. - Image Lightbox: Full-screen preview for graphics. - Binary Handling: Safe "Download-only" prompt for .exe, .dmg, and .zip. 4.4 Control & Sharing - Rename/Delete functionality. - "Share Link" Generator: Creates a local blob link for instant sharing. - Download Controller: One-click download for any stored file. 5. USER INTERFACE (UI) REQUIREMENTS - Mobile-First Design: Optimized for touch interactions and mobile browsers. - Aesthetic: Glassmorphism (frosted glass) with dark/light mode toggle. - Navigation: Bottom navigation bar for mobile or sidebar for desktop. 6. TECHNICAL CONSTRAINTS - The entire application logic, styling, and structure must reside in a single .html file. - Must not require a local server setup (Zero-setup). - Must utilize IndexedDB for large file handling to bypass LocalStorage limits (5MB). 7. FUTURE SCOPE (V2.0) - Cloud Sync (Firebase/Supabase Integration). - Password protection for specific files. - Version control for code files.