Cloud Storage

Rostyman is local-first by default, but you can optionally connect cloud storage providers to share collections with teammates. Cloud Storage supports Google Drive and Dropbox.

Connecting a Provider

1. Open Settings > Cloud Storage
2. Click Connect next to Google Drive or Dropbox
3. A browser window opens — sign in and grant Rostyman access (uses OAuth2 PKCE for security — no secrets stored in the app)
4. Once authorized, a green checkmark appears next to the provider name

You can connect both providers simultaneously. Each connection is independent. Tokens are stored encrypted and refreshed automatically.

Sharing a Collection

Once a provider is connected, you can share any collection:

From the Sidebar

1. Right-click a collection in the sidebar
2. Select Share to Cloud
3. Choose your connected provider (Google Drive or Dropbox)
4. Rostyman uploads the collection as a .rostyman file to a Rostyman folder in your cloud drive
5. A shareable link is automatically generated

From the Collection View

1. Open the collection by clicking it in the sidebar
2. In the Overview tab, find the Share Sources section
3. Click Share to Cloud...
4. Choose your provider

Send the generated link to any teammate who uses Rostyman.

What Gets Shared

• All requests (method, URL, headers, params, body, auth)
• Folder structure
• Collection-level variables
• Environments and environment variables
• Pre-request and post-response scripts

What Does NOT Get Shared

• Vault secrets — never uploaded for security reasons
• Request history — stays local to each user
• Personal settings — themes, editor preferences, etc.

Publishing Updates

After sharing, you can push changes to the cloud without creating a new link:

From the Collection View

1. Open the collection's Overview tab
2. In the Share Sources section, click the Publish button on your cloud share
3. The existing cloud file is updated — the shareable link stays the same

From the Share Dialog

1. Right-click > Share to Cloud (or click Share to Cloud... in the Overview tab)
2. The dialog shows Currently shared with the provider name, URL, and last published date
3. Click Update shared file to push the latest version

The last published date is shown on each cloud share so you know when it was last updated.

Share Sources Panel

The collection Overview tab shows all linked sources in the Share Sources section:

Source Type	Description
File	A local file linked via import (with format badge like POSTMAN, OPENAPI)
Cloud	A Google Drive or Dropbox share (with provider badge)

For each source, you can:

Action	Icon	Description
Publish	Send icon	Update cloud file with latest changes (cloud only)
Copy	Copy icon	Copy the URL or file path to clipboard
Open	External link icon	Open cloud link in browser (cloud only)
Remove	Trash icon	Remove source (with confirmation, moves to Trash)

Cloud Share Link Validation

Rostyman automatically checks if your cloud share links are still valid:

• Runs on app startup (3-second delay) and at the source check interval (default: every 5 minutes)
• If a link returns an error (e.g., file deleted from cloud), a warning notification appears in the Notifications panel
• Temporary network errors are skipped — no false alarms

How Teammates Import Shared Links

When a teammate receives your shared link:

1. Go to File > Import, select the URL tab, paste the link, and click Import
2. The collection appears in their sidebar, ready to use
3. Enable Source Watching to get notified when you publish updates

Removing a Cloud Share

You can remove a cloud share from:

• The Share Sources section in the collection view (trash icon)
• The Share to Cloud dialog (Remove button)

A confirmation dialog appears before removal. Removing a share:

• Unlinks the share reference from Rostyman's database
• Does not delete the file from your cloud storage
• The removed share goes to Trash and can be restored
• The shareable link remains valid until the file is manually deleted from your cloud drive

Preventing Duplicate Shares

You cannot share the same collection to the same provider twice. If a collection is already shared to Dropbox, the Dropbox option is hidden in the share dialog. To switch providers:

1. Remove the existing share
2. Share to the new provider

Managing Connections

In Settings > Cloud Storage, you can:

Action	Description
Connect	Link a new Google Drive or Dropbox account
Disconnect	Remove the connection (shared files remain in the cloud)

Tips

• Cloud Storage is completely optional — Rostyman works fully offline without it
• One active cloud share per collection
• For version-controlled collaboration, consider Git-Native Storage instead
• The shareable link is permanent as long as the file exists in your cloud storage
• Vault secrets are never uploaded — only non-secret variables are included