Zentara Studio Reference Guide
Complete documentation covering project setup, agent workflow modes, review controls, multi-device previews, and cloud deployment.
1. Getting Started
Zentara is a private AI Cloud Studio designed to turn English prompts and visual requests into working web applications. To begin, sign in to your Zentara account or start building a free project directly from the studio.
2. Creating Projects & Templates
From the Projects dashboard, you have four ways to initiate a workspace:
- Start with AI: Enter a prompt and let Zentara synthesize your initial app structure.
- Build my prompt: Use the guided prompt wizard to specify customer personas, data models, and features.
- Import GitHub: Connect your GitHub account and import an existing repository.
- Create Blank: Start with a clean, blank project template.
3. Plan, Build & Ask Modes
The Agent composer includes three dedicated operational modes:
Inspects project files, lists proposed changes and validation steps, and requires customer approval before modifying files.
Synthesizes code across multiple files and automatically runs typecheck and build validation in the sandbox.
Answers technical questions, explains components, and provides architectural advice with zero file modifications.
4. Reviewing and Applying Changes
When a build completes, Zentara stages the changes in a Review Changes card instead of immediately overwriting your workspace.
- Inspect Diffs: View line-by-line additions and deletions for every staged file.
- Validation Status: Passing checks (Typecheck, Build) are verified before "Apply changes" is unlocked.
- Apply or Reject: Click "Apply changes" to promote files to your accepted project, or click "Reject" to discard and roll back immediately.
5. Multi-Device Live Preview
The Live Preview panel runs your active project inside an isolated development server:
- Desktop: Scales to occupy 85–95%+ of the preview workspace with full fluid width.
- Tablet: 768×1024 portrait / 1024×768 landscape with rotation toggle.
- Phone: 390×844 mobile frame with orientation toggle.
- Reset Size: Instantly resets zoom and scale if drawer widths change.
6. Files, Assets & Uploads
Use the Files and Uploads drawers in the studio:
- File Explorer: Create, rename, view, and delete project files.
- Upload Assets: Drag and drop images, PDFs, CSVs, or design mockups into your project storage.
- Attach to AI: Click "Attach" on any uploaded asset to feed its context directly to the Agent.
7. Checkpoints & Instant Rollback
Every build automatically creates an immutable pre-build snapshot checkpoint. Open the Checkpoints modal from the Project Toolbar to view snapshot timestamps, file counts, and restore any previous version in seconds.
8. Runtime & One-Click Deployments
The studio includes full lifecycle management for cloud runtimes and production deployments:
- Runtime Control: Start, stop, or restart your sandbox server from the top toolbar.
- Deployment Panel: Trigger production cloud deployments and manage custom domains.
- GitHub Push & Export: Export the clean project source directly to a private GitHub repository.
9. Account Security & Privacy
All user accounts, project repositories, database collections, and uploaded files are isolated strictly under authenticated session boundaries. Secrets and connection strings are automatically redacted from all visible logs.