Cloud Clipboard - Copy & Paste Text Anywhere!

Cloud Clipboard is a lightweight tool that lets you copy code in one VS Code instance and paste it instantly in another, across different machines, OSs, or networks. No more emailing links to yourself or using messaging apps as temporary storage.

✨ Features

Code instance and paste it instantly in another—across different machines, OSs, or networks.

Instant Sync: Copy on your desktop, paste on your laptop.
Multi-Slot Support: Save multiple snippets to different "slots" in the cloud.
Cross-Platform: Works wherever VS Code runs (Windows, macOS, Linux, and Web).

🛠️ Infrastructure & Setup

To keep this tool lightweight, private, free to use, and avoid overloading free-tier resources, it is recommended to provide your own API endpoint.

Why a Custom Endpoint?

Zero Data Logging: Since you host the backend, your clipboard data never passes through a third-party server.
Resource Management: By setting up your own endpoint (e.g., on a free tier like Render, Railway, or a home Raspberry Pi), you avoid shared rate limits and service "cold starts."
Full Control: You decide how long your clipboard history is stored and who has access.

⚙️ Setup & API Configuration

1. API Specifications

The client communicates via a RESTful interface. Each request requires a connection (your private ID) and a clipboard (a specific slot or namespace).

1.2 Data Schema

All data exchanged (except for the /list endpoint) must be a JSON Array of Objects with the following structure:

[{ "file": string, "content": string }]

Method	Endpoint	Query Parameters	Content-Type	Action
GET	`/`	`connection, clipboard`	`None`	Returns the stored array for that clipboard.
GET	`/list`	`connection`	`None`	Returns an array of available clipboard e.g. ["s1", "s2"].
POST	`/`	`connection, clipboard`	`Array`	Overwrites the clipboard with the new content body.

2. VS Code Extension Configuration

To link your VS Code extension to your API Endpoint:

Open Settings (Ctrl + , or Cmd + ,).
Search for "Cloud Clipboard".
Fill in your specific details:
- API Endpoint: https://example.com
- Connection: example

3. Error Handling

To ensure Cloud Clipboard handles issues gracefully, your API should return the following status codes:

200 OK: Request successful.
400 Bad Request: Missing connection or clipboard parameters, or invalid body format.
500 Internal Server Error: Server-side failure.

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create.

Any contributions are greatly appreciated.

📄 License

Distributed under the MIT License.

Cloud Clipboard

AylexCODE