Documentation

AI Builder

AI Builder by SaudiCollabs is a platform that lets you create any kind of digital product — web apps, mobile apps, presentations, research reports, videos, and more — just by describing what you want in plain language. No coding skills required.

Under the hood, AI Builder uses a two-stage AI pipeline: an Orchestrator that plans your project into phases, and a Worker that writes every file. You can choose from 10+ AI models for each role, mix and match, and watch the entire process happen in real time.

ℹ️
This documentation covers all features of AI Builder. If you're new, start with the Quick Start guide.

Quick Start

Building your first app takes less than a minute. Here's how:

Step 1 — Describe your app

On the home page, type a description of what you want to build in the large text box. Be as specific or as general as you like. For example:

A to-do list app with categories, due dates, and a dark theme.
A Quran reader with surah navigation, Arabic text, translation toggle, and audio playback.
A finance dashboard showing stock prices, portfolio value, and a candlestick chart.

Step 2 — Choose your build type

Select what you want to build using the task type buttons below the text box. The default is Build App (a web application). You can also choose Presentation, Document, Research Report, Video, or Web Task.

Step 3 — Pick your AI models

Choose an Orchestrator model (plans the build) and a Worker model (writes the code). The default is GPT-5 Nano, the lowest-cost OpenAI GPT API model.

Step 4 — Hit Create & Build

Click the 🚀 Create & Build button. Watch the AI plan your project, write every file, and deploy it — all in real time. When it's done, click the preview link to see your app live.

💡
Tip: The more detail you give, the better the result. Mention colors, features, layout preferences, and any specific data or content you want included.

Interface Overview

The AI Builder interface has several key areas:

AreaDescription
Prompt BoxWhere you describe your app. Supports multi-line text. Click "Chat with AI" to refine your prompt interactively.
Task TypeButtons to select what you're building: App, Presentation, Document, Research, Video, or Web Task.
App TypeFor apps: choose Web, Mobile, Desktop, API/Backend, or CLI Tool.
AI ModelsSelect the Orchestrator and Worker models independently.
Project NameOptional. If left blank, AI generates a name automatically.
Supervised ModeToggle to pause at each build phase for your review.
Create & BuildStarts the build process.
My ProjectsShows all your previously built projects with links to open them.
Theme ButtonTop-right button to switch the UI theme (Dark, White, Blue, etc.).
Apps & ThemesTop nav link to browse all apps and preview them with any theme.
Custom AgentsTop nav link to build automation agents.

🔨 Build an App

The Build App task type creates a fully functional application from your description. The AI writes HTML, CSS, JavaScript, and any other files needed — then deploys it instantly to a live preview URL.

App Types

🌐
Web App
Standard web application. Runs in any browser.
📱
Mobile App
Mobile-optimized UI with touch interactions.
🖥️
Desktop App
Desktop-style layout with panels and menus.
⚙️
API / Backend
REST API or backend service with full code.
💻
CLI Tool
Command-line script or utility.

Advanced Options

Click Advanced options to choose a specific programming language (JavaScript, Python, TypeScript, etc.) and framework (React, Vanilla JS, Vue, etc.).

After the build

When the build is complete, your app is live at /preview/{project-name}/. From the preview page, you can:

  • Switch themes using the Theme button (top-right)
  • Navigate to other apps using the App Switcher button (top-right)
  • Go back to the builder to add features or fix issues

📊 Presentations

The Presentation task type generates a complete slide deck from your description. The AI creates slides with titles, content, charts, and visuals — all formatted professionally.

You can choose a presentation theme (Modern, Corporate, Creative, etc.) and specify the number of slides. The output is an interactive HTML presentation that you can view in the browser and export.

💡
Include key points you want on each slide, the audience, and the tone (formal, casual, technical) for best results.

📄 Documents

The Document task type creates structured documents like CVs, invoices, reports, proposals, and contracts. The AI formats them professionally and fills in all the content you describe.

A professional CV for a software engineer with 5 years of experience in React and Node.js.
An invoice for web design services, $2,500 total, due in 30 days.

🔍 Research Reports

The Research Report task type performs deep research on any topic and produces a comprehensive, structured report with sources, analysis, and key findings.

The AI searches the web, reads multiple sources, and synthesizes the information into a well-organized document. This is ideal for market research, competitive analysis, academic summaries, and topic deep-dives.

🎬 AI Videos

The Generate Video task type creates AI-generated videos from a text description. Choose from three video models and set the duration.

ModelBest ForDuration
Kling 1.6 ProCinematic, realistic scenes5s – 2min
Seedance 2.0Creative, stylized content5s – 5min
Veo 3.1High-quality, detailed scenes5s – 1min
⚠️
Video generation consumes more credits than app builds. Check the cost estimate shown before starting.

🌐 Web Tasks

The Web Task task type lets AI browse the internet and complete tasks for you. Common use cases include:

  • Flight search — Find the cheapest flights between two cities on specific dates
  • Apartment/villa search — Search property listings with your criteria
  • Custom web task — Any task that requires browsing: price comparison, data extraction, form filling, etc.
Find the cheapest round-trip flights from Riyadh to London in July 2025 for 2 adults.

Choosing a Model

AI Builder lets you choose AI models independently for two roles: the Orchestrator (which plans the build) and the Worker (which writes the actual code and content).

💡
Current default: Use GPT-5 Nano for both roles when minimizing API cost is the priority.

Orchestrator vs Worker

Orchestrator

The Orchestrator reads your prompt and creates a detailed build plan — breaking the project into phases, deciding what files to create, and defining the architecture. It needs to be good at reasoning and planning.

Best choices: DeepSeek V4 Pro, DeepSeek Reasoner, GPT-4.1, Claude Opus 4.5

Worker

The Worker receives the plan from the Orchestrator and writes every file — HTML, CSS, JavaScript, Python, etc. It needs to be good at following instructions and writing clean code.

Best choices: DeepSeek V4 Pro, DeepSeek V4 Flash (faster/cheaper), GPT-4.1 Mini, Claude Sonnet 4.5

Model Reference

ModelProviderSpeedBest For
GPT-5 NanoOpenAIVery FastCurrent default and lowest OpenAI GPT API cost.
DeepSeek V4 ProDeepSeekFastHigher-cost alternative for complex work.
DeepSeek V4 FlashDeepSeekVery FastQuick builds, simple apps, low cost.
DeepSeek ReasonerDeepSeekSlowerComplex logic, math, reasoning tasks.
Gemini 2.5 FlashGoogleVery FastFast builds, good quality.
Gemini 2.5 ProGoogleFastHigh-quality, complex apps.
GPT-4.1OpenAIMediumBest quality for complex projects.
GPT-4.1 MiniOpenAIFastBalanced quality and speed.
GPT-4.1 NanoOpenAIVery FastSimple tasks, lowest cost.
Claude Opus 4.5AnthropicSlowMost powerful, best for complex reasoning.
Claude Sonnet 4.5AnthropicMediumBalanced. Great for creative tasks.
Claude Haiku 4.5AnthropicFastFast and affordable.

🤝 Supervised Mode

Supervised Mode (also called Human-in-the-Loop or HITL) pauses the build at each phase and waits for your approval before continuing. This gives you full control over the build process.

When Supervised Mode is on, you can:

  • Review the Orchestrator's plan before any code is written
  • Approve or modify the GUI design before features are added
  • Review each feature before it's implemented
  • Stop the build at any point

To enable it, check the 🤝 Supervised checkbox next to the Create & Build button.

💡
Use Supervised Mode for important projects where you want to guide the AI's decisions, or when you want to learn how the AI plans and builds.

🎨 Themes

AI Builder has a built-in theme system that applies to both the builder interface and every app you build. There are 6 themes available:

ThemeDescription
🌑 DarkDeep black background with purple accents. The default theme.
☀️ WhiteClean white background with purple accents. Great for daytime use.
🔵 Blue-WhiteLight blue background with blue accents. Professional and calm.
🟠 Orange-BlackDark background with warm orange accents. High contrast.
🟢 GreenDark green background with emerald accents. Easy on the eyes.
🩶 GreyNeutral grey tones. Minimal and clean.

Switching themes

Click the theme button in the top-right corner of any page. Your selection is saved automatically and applies to all pages — the builder, admin panel, custom agents, and apps navigator.

Themes on preview pages

Every app preview page also has a Theme button in the top-right corner. This applies the selected theme to the app itself — changing its background, colors, and accents instantly without rebuilding.

ℹ️
The preview page theme system is separate from the builder theme. You can use a dark builder theme while previewing an app in white mode.

🤖 Custom Agents

Custom Agents let you build automation workflows that run on a schedule or on demand. An agent is a sequence of steps — each step can browse a website, click a button, fill a form, extract data, or wait for a condition.

Creating an agent

Go to Custom Agents and either:

  • Describe it in plain language — Type what you want the agent to do and click "✨ Generate Steps". AI will create the steps for you.
  • Add steps manually — Click "+ Add Step" and configure each step yourself.
  • Record your actions — Click "🔴 Record" and perform the actions in your browser. The agent will replay them automatically.

Step types

StepDescription
NavigateGo to a URL
ClickClick an element on the page
TypeType text into an input field
ExtractExtract data from the page
WaitWait for a condition or a fixed time
ScreenshotTake a screenshot of the current page

Scheduling

Agents can run:

  • Manually — Click "▶ Run Now"
  • Every X minutes — Set a recurring interval
  • Daily — At a specific time each day
  • Every Sunday — Weekly on Sundays
  • Time Window — Only run between specific hours

Saved credentials

Store login credentials securely for sites your agents need to access. Credentials are encrypted and only used by your agents.

📱 Apps & Themes Navigator

The Apps & Themes page gives you a central place to browse all your built apps and preview any of them with any theme.

Select an app from the dropdown, choose a theme using the swatch buttons, and click 🚀 Open Preview. The app loads in an inline preview frame on the same page — or click the ↗ button to open it full-screen.

Every preview page also has a floating App Switcher button in the top-right corner. Click it to see all your apps in a searchable dropdown and navigate between them instantly.

💬 AI Prompt Crafter

Not sure how to describe your app? Click "🤖 Chat with AI to craft your prompt" below the text box. This opens a chat interface where you can describe your idea conversationally and AI will help you turn it into a detailed, effective build prompt.

When you're happy with the prompt, click "Use this prompt" and it will be inserted into the build box automatically.

💰 Credits & Pricing

AI Builder uses a credit system. Each build consumes credits based on the AI models used and the complexity of the project. Your current balance is shown in the top-right corner of the home page.

Click the credit balance pill to add more credits. Video generation and research reports typically cost more than app builds due to the additional AI processing involved.

💡
Use DeepSeek V4 Flash as the Worker model for simple apps to reduce credit usage while maintaining good quality.

💡 Tips & Best Practices

Writing better prompts

  • Be specific about features — List the exact features you want, not just the app type.
  • Mention the design — Say "dark theme", "minimal", "colorful", or describe the layout.
  • Include sample data — For data-heavy apps, describe the data structure or give examples.
  • Specify the audience — "For children", "for developers", "for Arabic speakers" helps AI tailor the UI.

Choosing the right build type

  • Use Build App for anything interactive — calculators, games, dashboards, tools.
  • Use Presentation for slide decks you'll present to others.
  • Use Research Report when you need information gathered and organized from the web.
  • Use Web Task when you need AI to actually browse and interact with a website.

Iterating on your app

After a build, go back to the builder and open your project. You can describe changes or new features and AI will update the existing app — it doesn't start from scratch.

❓ FAQ

Do I need to know how to code?

No. AI Builder is designed for everyone. You just describe what you want in plain language.

Can I edit the code after it's built?

Yes. The builder shows all generated files and you can edit them directly, or ask AI to make specific changes.

How long does a build take?

Most app builds complete in 30–90 seconds. Research reports and complex apps may take 2–5 minutes.

Can I use Arabic in my prompts?

Yes. AI Builder supports Arabic prompts and can build apps with Arabic content, RTL layouts, and Arabic text.

What happens if the build fails?

The builder shows an error message with details. You can try again with a more specific prompt, or switch to a different AI model.

Can I share my built apps?

Yes. Every app has a public preview URL at saudicollabs.com/preview/{project-name}/ that you can share with anyone.

Are my projects private?

Your projects are linked to your account. Preview URLs are publicly accessible by default — if you need private apps, contact support.