WarpBox/static/popups/faq.html

<h3><u>Help &amp; FAQ</u></h3>

<div style="background:#ffffff; border-top:1px solid #808080; border-left:1px solid #808080; border-right:1px solid #ffffff; border-bottom:1px solid #ffffff; padding:10px; margin:0 0 12px;">
    <p><strong>> Fast path:</strong> Add files, choose any Box Options you need, then start the upload. WarpBox creates one share link for the whole box.</p>
    <ol>
        <li><strong>Add files:</strong> drag files onto the window or use <span class="kbd">Ctrl</span> + <span class="kbd">O</span>.</li>
        <li><strong>Check options:</strong> set expiry, password, ZIP download, or one-time download before uploading.</li>
        <li><strong>Upload:</strong> press <span class="kbd">Ctrl</span> + <span class="kbd">U</span> or use the Upload button.</li>
        <li><strong>Share:</strong> copy the returned link with <span class="kbd">Ctrl</span> + <span class="kbd">L</span>.</li>
    </ol>
</div>

<section class="shortcut-section">
    <h4><u>Keyboard Shortcuts</u></h4>
    <ul class="shortcut-list">
        <li><span><span class="kbd">Ctrl</span> + <span class="kbd">O</span></span><span> Browse for files.</span></li>
        <li><span><span class="kbd">Ctrl</span> + <span class="kbd">U</span></span><span> Start the current upload.</span></li>
        <li><span><span class="kbd">Ctrl</span> + <span class="kbd">K</span></span><span> Copy the full cURL command.</span></li>
        <li><span><span class="kbd">Ctrl</span> + <span class="kbd">L</span></span><span> Copy the share URL after upload.</span></li>
        <li><span><span class="kbd">F1</span></span><span> Open this help window.</span></li>
        <li><span><span class="kbd">Esc</span></span><span> Close menus and popups.</span></li>
    </ul>
</section>

<h4><u>Common Questions</u></h4>
<div class="faq-list">
    <div class="faq-item">
        <p><strong>What is a box?</strong></p>
        <p>A box is the temporary share page WarpBox creates after upload. It can contain one file or many files, plus the manifest that records upload status.</p>
    </div>
    <div class="faq-item">
        <p><strong>Can I password protect uploads?</strong></p>
        <p>Yes. Set a password in Box Options before starting the upload. Anyone opening the box must enter that password before downloading protected files.</p>
    </div>
    <div class="faq-item">
        <p><strong>How does expiry work?</strong></p>
        <p>The expiry value is sent with the upload as <code>retention</code>. After that period, the server may delete the box and its files according to the running WarpBox configuration.</p>
    </div>
    <div class="faq-item">
        <p><strong>What does one-time download do?</strong></p>
        <p>One-time download tells the backend to treat a file or box as burn-after-read. After a successful download, the link should no longer be reusable.</p>
    </div>
    <div class="faq-item">
        <p><strong>Can people download everything at once?</strong></p>
        <p>Enable ZIP download before uploading. When supported by the backend, the share page offers a single archive for the box.</p>
    </div>
    <div class="faq-item">
        <p><strong>What happens if one file fails?</strong></p>
        <p>The failed row stays red, successful files remain available, and WarpBox marks the failed file in the manifest so you can tell what needs another attempt.</p>
    </div>
    <div class="faq-item">
        <p><strong>Can I upload from terminal or automation?</strong></p>
        <p>Yes. Use the CLI help window for ready-made <code>curl</code>, shell, Node.js, Go, and Java examples. Copy command with <span class="kbd">Ctrl</span> + <span class="kbd">K</span>.</p>
    </div>
    <div class="faq-item">
        <p><strong>Are all options server-backed?</strong></p>
        <p>Expiry, password, ZIP download, and one-time download are sent to the backend. Box name, custom slug, and API key mode are saved locally until backend support exists.</p>
    </div>
</div>

<h4><u>Troubleshooting</u></h4>
<div class="faq-list">
    <div class="faq-item">
        <p><strong>Upload button is disabled.</strong></p>
        <p>Add at least one file, remove duplicates if prompted, and check Upload Limits for configured box and single-file limits.</p>
    </div>
    <div class="faq-item">
        <p><strong>Copy failed.</strong></p>
        <p>Some browsers block clipboard access outside secure contexts or direct user gestures. WarpBox shows a fallback text box so the link or command can be selected manually.</p>
    </div>
    <div class="faq-item">
        <p><strong>Shared link opens but download fails.</strong></p>
        <p>The box may be expired, consumed by one-time download, password-protected, or removed by server cleanup. Re-upload the file if the box is no longer available.</p>
    </div>
    <div class="faq-item">
        <p><strong>Large file fails early.</strong></p>
        <p>Check Upload Limits first. If the file is inside limits, retry on a stable connection or use the terminal upload flow so the exact server error is visible.</p>
    </div>
</div>