Commands
Open the command palette (Ctrl+Shift+P / Cmd+Shift+P) and type Square Cloud.
With an account connected, the palette also runs the application and database actions. Each one asks which application or database to use and lists only the ones it applies to: Start offers applications that aren’t running, Stop and Restart the ones that aren’t stopped, the edge tools only websites, and metrics only applications with 512 MB or more.
The same actions are in the menu of each card in the side bar: right-click an application, database or workspace, or use its ⋯ button.
Settings
Activation and refresh
The extension activates only when needed: when the workspace has asquarecloud.app or squarecloud.config file, or when you open the Square Cloud side bar, run one of its commands or open a config file. Until then, it has no background activity.
Once active, it refreshes your account every 60 seconds. Polling pauses while the VS Code window is out of focus and refreshes as soon as you come back, so an idle editor doesn’t spend your API quota. When a rate limit is hit, background polling pauses for a few minutes and the side bar keeps what is already on screen.
Troubleshooting
Nothing shows up in the side bar
Nothing shows up in the side bar
Check that an account is connected: without one, the side bar shows the sign-in screen. If Square Cloud can’t be reached, is pausing requests or is under maintenance, the side bar says which, with Try again and Service status buttons.
Someone sent you a code or a link to approve
Someone sent you a code or a link to approve
Don’t enter it. Approving someone else’s code connects their editor to your account. If the page rejects the code you pasted, start over from VS Code.
Upload fails with a missing config error
Upload fails with a missing config error
The chosen folder needs a
squarecloud.app or squarecloud.config file at its root. See the config file guide.Upload fails because the zip is too large
Upload fails because the zip is too large
Zips are limited to 100 MB. Add build output, caches and dependency folders to
squarecloud.ignore. node_modules and .git are already left out, and dependencies are installed on the platform from your manifest.A command failed with a rate-limit message
A command failed with a rate-limit message
Wait before trying again. Background polling already backs off on its own, and retrying over and over only keeps the limit in place.
Diagnosing anything else
Diagnosing anything else
Open View → Output and pick the Square Cloud channel for a log of every API call, and include it when you report a bug on GitHub.
The data looks stale
The data looks stale
Click the status bar item or the refresh icon in the side bar’s title bar. Remember that polling pauses while the window is out of focus.