Upload, File Storage, and Sync

This guide explains how files enter the app, where they are saved, and how updates work.

📤 Ways to upload

You can import in three ways:

• drag and drop files/folders;
• choose files with the upload button;
• choose a full folder with the upload button.

⏳ What happens during upload

Usually you will see three moments:

1. the app finds your files;
2. the app reads your files;
3. the app saves your files.

You can follow all this through the progress bar.

🗃️ Where files are stored

Your files are saved in your browser on your current device.

That gives you:

• fast local access;
• offline use after the app is ready.

🔁 How updates work

If you upload the same folder again:

• existing files can be updated;
• new files are added;
• you do not need to rebuild everything from zero.

🔗 Linking to disk

When you pick a folder from your computer, the app can link your files to their source on disk.

• linked items show an origin indicator (disk/link icon);
• this link lets the app reconcile with whatever changed in the original folder;
• files imported without a link live only in the browser.

🔄 Syncing with disk

When a link exists, a Sync button appears. It compares what's in the app with what's on disk and shows the differences:

• new or changed files on disk are pulled in;
• files removed from disk show up as a pending deletion;
• before deleting, the app opens a decision dialog so you confirm what to do.

This way you never lose anything by accident: deletion only happens with your confirmation.

Sync follows a disk → library flow: it brings changes from the original folder into the app but does not modify files on disk. Detected deletions remain pending until you manually decide what to do.

⚙️ Customizing sync

In the Sync settings tab, you can:

• turn automatic sync on or off;
• use Adaptive, Fixed interval, or Manual only mode;
• choose a fixed interval of 2, 5, 10, 15, 30, or 60 minutes;
• sync when the app opens or when you return to its tab;
• receive notifications always, only when changes are found, only for errors, or never.

These checks run only while the app is open and active. The browser may suspend tasks when the tab is inactive, so this feature does not replace continuous background sync.

🏷️ Display name

You can rename how a file or folder appears in the app without affecting:

• the original file on disk;
• the sync link;
• the stored content.

It's just a visual label to keep your reading organized.

✅ Good practices

• keep your notes in clear folders before upload;
• use clear file names;
• export backups regularly.