company logo

Help Center

Go to Aesthetix CRM
Terms & ConditionsPrivacy Policy
All collectionsAI EmployeeAI StudioAI Studio Cloud Backend

AI Studio Cloud Backend

Enable and manage the built-in Cloud backend for AI Studio apps: database, user sign-in, file storage, backups, security settings, pausing and removing Cloud.

Cloud gives an AI Studio app a built-in backend so it can store data, manage app user accounts and handle file uploads without a separate backend service. Each project gets its own managed Cloud environment, which you manage from the Cloud tab inside the AI Studio builder (AI Agents > AI Studio, open a project, then More > Cloud).

Do not store PHI in Cloud (critical): AI Studio is an AI feature and is not approved for Protected Health Information (PHI). Cloud databases, user records and file storage must never hold patient records, treatment notes, intake or consent forms, before-and-after photos, lab results, or any other PHI. Keep Cloud for non-PHI uses such as event sign-ups, a product catalog, a public resource library, staff-only tools or marketing content. Do not put PHI into prompts you send to the AI Studio chat either, including requests like "Optimize" that send information to chat.

What Cloud is and when to enable it

Cloud provides:

  • A database for structured data such as lists, orders or registrations.

  • Authentication so people can sign up and log in to your app.

  • File storage for uploads such as images and documents.

Enable Cloud when the app you are building needs to remember data, require logins or accept file uploads. You do not need it for a simple marketing page. Forms that you connect to the Aesthetix CRM send submissions to your CRM, not to Cloud; Cloud storage is a separate capability.

You can view stored information, configure access, manage resources, and ask AI Studio to create database tables or policies. AI Studio asks for your confirmation before building features that use Cloud.

Enable Cloud

Prerequisite: Cloud supports projects built on TanStack Start (all projects created on or after September 8, 2026). If you have an older React project, open Project Settings and use Migrate to SSR first. Migration creates an upgraded copy and leaves your live project unchanged. You then enable Cloud separately on the copy. See "AI Studio Full-Stack Development: SSR, Server Functions, REST APIs and Secrets".

  1. Log in to your account.

  2. Open AI Agents and select AI Studio.

  3. Create a project by describing your app, or open an existing project.

  4. When the project is ready, click More > Cloud in the builder.

  5. Open Overview and click Enable Cloud.

  6. Wait for provisioning to finish (usually about a minute). You can keep working while it runs.

  7. When connected, the Cloud dashboard shows Database, Users, Storage and Secrets.

If setup fails, your existing app is unchanged. Click Try again to resume.

Enabling Cloud does not update your published app. Your published app stays as it is until you publish the updated project again.

Cloud Overview dashboard

Go to Cloud > Overview to monitor your backend. It shows:

  • Connection status: whether your Cloud instance is connected.

  • Database: existing tables and their record counts.

  • Users: registered user counts and authentication settings.

  • Storage: the storage buckets your app uses.

  • Secrets: access to the project's Secrets area.

Click any section to open its management page. Advanced settings (database size, storage, pause, remove) are also reached from Overview.

Database

The database stores your app's structured data, such as user profiles, orders and other records. Row-level security (RLS) policies control which records each user can access. Open it at Cloud > Database.

Manage tables and records

The Database page lists the tables in your project's public schema with approximate row counts and RLS status.

  • View records: select a table to open its data.

  • Add records: open a table and add rows.

  • Edit records: double-click a cell to change its value.

  • Delete records: select the rows and delete them.

  • Change the schema: ask AI Studio in chat to create or modify tables and policies. Schema changes go through AI Studio, not direct schema editing in the database browser.

  • Export: export tables as CSV files before removing Cloud.

Optimize the database

Click Optimize to send a database health-check request to the AI Studio chat, which can suggest performance improvements. Optimize uses AI Studio usage like any other chat request. See "AI Studio Pricing and Usage".

Row-level security (RLS) policies

An RLS policy can, for example, let a signed-in user view or update only their own records.

  1. Open Cloud > Database.

  2. Click RLS policies.

  3. Review each table's policies: name, command, applicable user role and rule expression.

  4. To change one, describe the access you want to AI Studio in chat.

Backups

Cloud automatically creates daily backups of your database schema and records.

  1. Go to Cloud > Database > Backups.

  2. Review the available backups.

  3. Select the one you need and click Restore.

Restoring replaces the current live database with the selected backup, and database access is interrupted for a few minutes. Backups do not include uploaded storage files or application code. If the restored schema no longer matches your app, ask AI Studio to update the code.

Users and authentication

Open Cloud > Users to manage the people who sign in to your app.

  • Monitor signups: the Signups chart has a date-range filter.

  • Search users: find users by email address.

  • Add user: creates an already-confirmed account without sending an email.

  • Send invitation: emails a link so the person can set a password.

  • View details: select a user to see sign-in methods and account information.

  • Delete user: open the account and select Delete user to remove it permanently.

Auth settings

Go to Cloud > Users > Auth settings.

Setting

Function

Sign-in methods

Choose supported sign-in methods. The initial release supports email and password.

Allow new sign-ups

Turn new registrations on or off without signing out existing users.

Anonymous users

Allow anonymous authentication when enabled.

Advanced

Additional authentication options.

Email and password security

Under Auth settings > Email:

  • Minimum password length: at least 6 characters; 8 or more is recommended.

  • Required password characters: which character groups a password must contain.

  • Check against known breaches: rejects passwords found in publicly known breaches.

  • Re-authenticate to change password: requires the current password before setting a new one.

  • Auto-confirm email: skips email verification. Use for testing only; email confirmation is on by default, and auto-confirm should stay off for live apps.

  • Secure email change: requires confirmation from both the old and new email addresses.

  • Advanced: one-time code expiration and length settings.

Authentication URLs

  • Site URL: the primary URL of your app.

  • Redirect URLs: URLs users may return to after authentication, including supported mobile deep links such as myapp://callback.

AI Studio handles preview URLs automatically. Make sure your configured URLs match the real app URLs; mismatches cause sign-in failures.

Signup confirmation, invitation and password reset emails are sent through your account's email configuration, and their links return users to your app.

Storage

Cloud Storage manages files your app uploads and uses, such as images and documents. Files live in buckets, with access controlled by bucket visibility and RLS policies. Open Cloud > Storage.

Create a bucket

  1. Click New bucket.

  2. Enter a name of 3 to 63 characters using lowercase letters, numbers and hyphens.

  3. Choose visibility: Public (anyone with the file link can open it) or Private (signed-in users only, subject to access policies).

  4. Create the bucket.

Bucket names cannot be changed after creation. Choose Private unless the file is truly meant to be public; never use Cloud storage for files containing PHI.

Manage files

Open a bucket to upload files and media, create folders, download or delete files, rename files, and copy file URLs. Renaming a file changes its URL, so update anything that referenced the old URL.

Upload limits and access

  • Upload size limit sets the largest file a bucket accepts. The default is 2 GB and the maximum is 5 GB. Click Save after changing it.

  • RLS policies shows the rules that control storage access.

Advanced settings

Go to Cloud > Overview > Advanced settings to control resources.

Database size

Cloud starts on the free Tiny instance. Available sizes are Tiny, Mini, Small, Medium, Large and X-Large. Click Manage next to Database size to see the options and their charges. You can increase or decrease the size once per hour. A change takes a few minutes and briefly restarts the application.

Database storage

Click Manage next to Database storage to add space. It can be increased up to four times per day and can never be decreased. It is charged on the space you reserve, even when Cloud is paused. File storage is different: it follows the files you actually store. Review current usage under Advanced settings > Database storage before increasing, since the change cannot be reversed.

For how charges work in concept, see "AI Studio Pricing and Usage". Pricing questions go to your Aesthetix CRM account team.

Pause or wake up

Click Pause under Pause Cloud to stop access to the backend while keeping its data. To reactivate, open the project's Cloud tab and click Wake up. Cloud can also be paused automatically if your account cannot cover Cloud charges, without deleting data. It wakes up automatically once the issue is resolved, which may take a while, or you can click Wake up yourself.

Remove Cloud

Click Remove under Remove Cloud to permanently delete the project's Cloud backend. This deletes the database, users and stored files. Export tables as CSV and download files first. Other AI Studio projects are not affected.

Sharing and remixing

When you share or remix an AI Studio project, the copy is disconnected from the original project's Cloud backend and sends no requests to it. If you enable Cloud on the copy, a new backend is created with the same table structure but none of the original records, users or files.

Troubleshooting

Problem

What to check

Enable Cloud is not available

Confirm the project is on the newer architecture; older React projects need Migrate to SSR first.

Setup fails

Click Try again; your app is unchanged in the meantime.

Sign-in or confirmation links fail

Check Site URL and Redirect URLs match your real app URLs.

Users are not getting emails

Signup, invite and reset emails use your account's email configuration. Check that setup.

New sign-ups are blocked

Allow new sign-ups may be off in Auth settings.

Images stop loading after a rename

Renaming a file changes its URL; update references.

Cloud is paused

Click Wake up on the Cloud tab, and resolve any wallet balance or spending limit issue.

Restore did not fix the app

Backups cover data and schema only; ask AI Studio to update code that no longer matches.

Cannot upload a large file

Raise the bucket Upload size limit (maximum 5 GB).

Frequently Asked Questions

Does enabling Cloud automatically update my published application?

No. Your published app stays unchanged until you publish the updated project again.

What happens to Cloud data when I share or remix a project?

The copy is disconnected from the original backend. If you enable Cloud on the copy, it gets the same table structure but no records, users or files.

Are submissions from AI Studio forms connected to the CRM stored in Cloud?

No. Those submissions go to your Aesthetix CRM account. Cloud storage is a separate capability.

Can I store patient information in Cloud?

No. AI Studio is not approved for PHI. Do not store patient records, photos or intake forms in Cloud databases or storage.

Where are authentication emails sent from?

Signup confirmation, invitation and password reset emails are sent through your account's email configuration, and the links return users to your app.

Can I change a bucket name or reduce database storage later?

No to both. Bucket names are fixed at creation, and database storage can only be increased.

What is the difference between pausing and removing Cloud?

Pausing stops the backend while keeping all data. Removing permanently deletes the database, users and files. Some storage charges can continue while paused, so see "AI Studio Pricing and Usage".

Will backups restore my uploaded files?

No. Backups cover database schema and records only, not storage files or application code.

How do I change a security policy?

Describe the access you want to AI Studio in chat. Schema and policy changes go through the chat rather than direct editing.

Did this answer your question?
😞
😐
😁