Files

Uploading a file

Files can be uploaded in two ways:

• Button — click + in the dashboard top bar and select Upload File
• Drag and drop — drag one or more files from your desktop and drop them anywhere on the dashboard

Files are uploaded to secure cloud storage (Cloudflare R2) and are private by default. A progress indicator appears per file during upload.

Auto-stash and auto-tag on upload

If you upload while a stash or tag filter is active, the uploaded files are automatically assigned to that stash or tag.

Supported file types

Unsupported file types are rejected at upload with an inline error message.

File size limits

Previewing a file

Click a file card to open the full-screen preview modal. The preview modal supports:

The modal header shows the filename and file size. Press Escape or click the backdrop to close. The Download button in the header saves the file to your device (requires an internet connection).

Offline access

By default, file names and metadata are available offline, but the file contents live in cloud storage and need a connection to load. Pin a file to keep its contents on your device so you can open it without internet.

Pin a file for offline use

1. Click the ⋮ more-actions button on any file card.
2. Select Make available offline.
3. A progress indicator runs while the file downloads to your device.
4. Once finished, the file is marked with a blue Offline badge.

After that, the file opens instantly from your device — the preview modal, image thumbnail, and Download button all work with no connection.

Across devices

The offline pin is part of the file's data, so it syncs to your other devices via the usual CRDT sync. Each device downloads its own copy the next time it is online — pinning on your laptop does not transfer the bytes to your phone, only the intent.

Large files

Offline cache strip

When you have any pinned files, an Offline cache row appears below the storage quota bar in the Files view. It shows the total size of files cached on this device and how many there are.

Click Manage to open a list of every pinned file. From there you can:

• See whether each file is Cached, Downloading…, or Not yet downloaded (e.g. pinned on another device but this device has not synced the blob yet).
• Click the trash icon next to a file to unpin it and free up local space.

Unpinning and automatic eviction

A file is removed from your local cache when:

• You unpin it (⋮ → Available offline toggles it back off).
• The file is moved to Trash or permanently deleted on any device.
• You clear your browser's site data. In this case the pin itself is preserved, so the file re-downloads automatically the next time you are online.

Sharing a file

Each file can be shared via a public share link. Only you can access private files; anyone with a share link can view or download the file without logging in.

Create a share link

1. Click a file card to open the share modal (or click the Share icon on the card).
2. In the Link Expiration section, select when the link should expire:
   • No expiry
   • 24 hours
   • 7 days
   • 30 days
3. Click Create share link.
4. Copy the generated link using the Copy Link button or the copy icon next to the URL.

The expiry date (if set) is shown below the share link.

Track downloads

The share modal displays a download count in the status banner — how many times the file has been downloaded through its public link.

Revoke a link

Click Revoke in the share modal to immediately make the file private again. All existing share links are invalidated instantly.

Organizing files

Files support the same organizational tools as notes and bookmarks:

• Stashes — group files with notes and bookmarks into a named collection
• Tags — apply labels to files
• Pin — press P on a file card to pin it to the top of the dashboard

Using files in notes

From the note editor, use / → Image to insert an image from your storage, or / → Attach File to insert any file as a clickable link. Clicking an attached file link in a note opens the preview modal directly.

Storage quota

Your total uploaded file storage counts against your plan's cloud storage quota:

When you are in the Files view, a storage bar is displayed at the top of the dashboard showing how much of your quota is used. The bar changes color as you approach your limit:

• Blue — normal usage
• Yellow — over 70% used
• Red — over 90% used

Deleting a file

• From the dashboard: click the ⋮ (more actions) button on a file card → select Delete → confirm with Delete.

Deleted files go to the Trash and can be recovered until you empty it.