What is Atoms Cloud?

Atoms Cloud provides the behind-the-scenes services your app needs to work with real users and information. It lets your app save data and files, manage users, securely store private credentials, and use AI features. Unlike a static site, an app connected to Atoms Cloud can remember information and respond to what users do.

The Agent builds both your app’s frontend and its backend. If your app needs a database, user authentication, or file storage, Atoms automatically connects Atoms Cloud during the build. You can also connect it manually to an existing supported project.

Once connected, Atoms manages the underlying infrastructure for you. You can use the Atoms Cloud workspace to view and manage your project’s cloud services, test your app during development, and publish it when it is ready.

This page provides an overview of Atoms Cloud and the features currently available in its workspace. For setup steps and detailed instructions, follow the dedicated guides.

Use the Atoms Cloud sidebar to open AI, Database, Users, Keys, and App Storage.

What you can manage in Atoms Cloud

Module	What it covers	Detailed guide
AI	Choose AI models for features in your app and review their usage.	Use AI in your app
Database	View and manage the structured data used by your app.	Database
Users	View and search the users registered with your app.	Authentication
Keys	Store and manage credentials that your app uses to access external services.	Keys and secrets
App Storage	Store and manage files used by your app.	App storage

As it builds your app, the Agent can set up and connect these services for you. Remember to test the results before publishing.

Before connecting

Atoms Cloud is available only for supported projects and can be managed only on desktop. A project already connected to Supabase cannot also connect to Atoms Cloud, and vice versa. Your Workspace permissions determine which modules you can access.

If Connect is blocked

Feature not available yet: Atoms Cloud is not open for the project. Wait until Atoms Cloud is available for the project, or contact Support to confirm eligibility.

Plan limit or Upgrade message: Follow the on-screen upgrade instructions, then return to the project and retry Connect.

Usage limit: The project has reached its allowance for this feature. Review the plan and usage information, follow any available upgrade or renewal option, and retry only after the limit is cleared.

Storage limit: The project has reached its image or file-storage limit. Remove unneeded stored files or increase the available storage if the product offers that option, then retry.

Another message is active: Finish the current Agent message or request before starting the connection, then retry.

Supabase is already connected: Keep Supabase if you want to continue using it. To switch to Atoms Cloud, disconnect Supabase first, then retry Connect.

Open or connect Atoms Cloud

If Atoms Cloud was not connected during the build, or you want to add it to an existing supported project, you can connect it manually.

1. Open the project on a desktop device.
2. In the same workspace toolbar where the App Viewer is, select Atoms Cloud.
3. If Atoms Cloud is not connected, select Connect. If you see Upgrade, follow the on-screen instructions to make the required plan or resource change. If another message blocks the connection, stop and use the recovery guidance in Before connecting.
4. The Agent enables Atoms Cloud and returns you to the App Viewer. Reopen Atoms Cloud to view its modules.

You can also ask the Agent directly in the project Chat to connect Atoms Cloud for you.

Open Atoms Cloud from the project toolbar.

Select Connect to enable Atoms Cloud for the project.

Cloud usage and publishing

Cloud and AI usage is measured separately from the credits you use to build your project. See Cloud & AI Wallet for current balances, usage and account controls.

When your app is ready, use Publish your project — Help Center draft to make it available at a live URL.

FAQ

Why is my Supabase Edge Function not working?

This troubleshooting path is for Supabase Edge Functions. Edge Functions are not one of the Atoms Cloud workspace modules listed above, so open the connected Supabase project to deploy, invoke, and review its function logs.

1. Trigger the function once and record the time, request, response status, and exact error.
2. Determine whether the function failed to deploy or deployed successfully but failed when called.
3. Review the function log for that timestamp. Check the request path and method, input, authentication, dependencies, and required environment-variable names. Never share secret values.
4. Make one targeted correction, deploy once, and repeat the same test.
5. Confirm the expected response and verify that related flows still work.

If the function still fails, contact Support with the Chat Link, function name, timestamp and timezone, reproduction steps, response status, and sanitized logs.

What does "Cloud / AI Wallet balance insufficient" mean?

This message means the usable balance for Cloud & AI services is too low for the requested action. That wallet is separate from the credits shown under Plans & Credits for agent usage.

1. Open Settings → Cloud & AI and review the available balance and recent usage.
2. If you choose to add funds, confirm the amount and payment details before completing the top-up.
3. Return to the blocked action and retry after the balance update is confirmed.

Promotional amounts and eligibility can change, so rely on the offer displayed in your own account rather than a fixed amount in this FAQ. A low balance may interrupt eligible cloud services or published applications. If a completed top-up is not reflected, do not pay again; contact Support with the transaction reference and a redacted screenshot.