Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/S4nti4goCoder/cloudsyncpro/llms.txt

Use this file to discover all available pages before exploring further.

CloudSyncPro stores all files and folders inside a workspace. Every item you see on the Files page belongs to the active workspace and lives in a hierarchical folder tree. You navigate that tree through a breadcrumb at the top of the page; the root level is labelled Root.

Uploading files

You can bring files into CloudSyncPro in two ways: by dropping them directly onto the page or by opening the upload dialog manually.
1

Open the Files page

Select Files in the sidebar. Make sure you are inside the folder where you want the files to land — the breadcrumb shows your current location.
2

Drop or click to upload

Drag one or more files from your desktop and drop them anywhere on the page. A blue overlay appears to confirm the target folder. Alternatively, click Upload file in the top-right toolbar to open the file picker dialog.
3

Confirm the upload

The upload dialog shows each file’s name, size, and category. Click Upload to start the transfer. Files are uploaded directly to Cloudflare R2 storage and then registered in the workspace.
Supported file types: documents — PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT; images — JPG, JPEG, PNG, WEBP, GIF, SVG, HEIC; videos — MP4, MOV, AVI, WEBM, MKV. Files with any other extension are rejected at upload time. The maximum total size per upload batch is 1 GB.
You can also upload an entire folder from your computer using the Upload folder button next to the upload button. The folder structure is reproduced in CloudSyncPro up to a maximum nesting depth of 10 levels.

Creating folders

Click New folder in the toolbar. An inline input appears in the file list — type the folder name and press Enter, or click Create. Press Escape to cancel. Folder names follow the same character rules as file names: they cannot contain .., /, \, or ASCII control characters. You can assign a color to any folder by opening its context menu (the icon) and choosing Color. Colors help you visually distinguish folders at a glance.

Grid and list views

Use the toggle in the top-right corner of the toolbar to switch between how files and folders are displayed.
Files appear as cards arranged in a responsive grid (2 columns on mobile, up to 5 on large screens). Each card shows a file-type icon, the file name, and the size and date. Folders display a colored top accent strip. Favorited items show a star badge in the top-right corner.
Your view preference is saved per section (Files, Trash) and persists across sessions.

Moving files and folders

You can move a single file by dragging it and dropping it onto any visible folder. The target folder highlights in blue while the file is being dragged. Dropping onto the Root breadcrumb button moves the file to the top level. To move a file via the menu, open the context menu on the file card and select Move to…. A folder picker dialog lets you choose any active folder in the workspace.

Renaming

Open the context menu on any file or folder and choose Rename. The name turns into an inline text field. Edit the name and press Enter to save, or Escape to cancel. The rename is logged in the workspace activity timeline.

Previewing files

Click on any file to open the preview modal. CloudSyncPro renders a built-in preview for:
  • Images (JPG, PNG, WEBP, GIF, SVG, HEIC) — displayed at full width, up to the modal height
  • PDFs — rendered in an inline viewer
  • Videos — played with native browser controls
  • Audio — played with native browser controls
Files that do not match any of the above types show a “no preview available” placeholder. You can navigate between files in the same folder using the arrow buttons inside the modal.

File status lifecycle

Every file in CloudSyncPro has a status that determines where it appears:
StatusWhere it appearsNotes
activeFiles pageDefault state for uploaded files
deletedTrash pageSoft-deleted; recoverable
archivedArchive pageLong-term storage; no expiry
Moving a file to trash sets its status to deleted. Archiving a file sets its status to archived. Both actions are reversible. Permanently deleting a file from the trash removes the object from Cloudflare R2 storage and the database row — this cannot be undone.

Storage limits per folder

Each folder enforces per-category limits on the number of active files it can hold. These limits apply both when uploading and when moving files into a folder.
CategoryDocumentsImagesVideos
Storage limit per folder305020
If adding a file would exceed the limit for its category, the upload or move is blocked and an error message shows how many more files of that type can be added. During a folder upload, a stricter upload batch limit applies per folder (20 documents, 30 images, 2 videos) to prevent very large batch uploads in a single operation.

Bulk operations

You can select multiple files and folders at once to perform operations on them together.
  1. Check the Select all checkbox in the toolbar, or check individual items by hovering over them and clicking the checkbox that appears.
  2. A sticky action bar appears at the top of the page showing the number of selected items.
  3. Choose one of the available bulk actions:
ActionApplies toEffect
MoveFiles and foldersOpens a folder picker to move all selected items to a new location
ArchiveFiles onlyMoves all selected files to the Archive
TrashFiles and foldersMoves all selected items to the Trash
RestoreFiles and foldersRestores all selected items to active (from Trash or Archive)
DeleteFiles and foldersPermanently deletes all selected items from storage
Click the button or press Escape to clear the selection without taking any action.

Build docs developers (and LLMs) love