Documentation
Everything you need to build with Atai
Step-by-step guides, detailed explanations, and answers to common questions. Learn how to go from an idea or competitor URL to a fully running business — with app, database, payments, users, marketing and infrastructure included.
Quick links — all pages
Atai SDK & API
@atai-group/sdk + Runtime API reference — keys, endpoints, limits
Developer Portal
Infrastructure services, quickstart, and API access
Pricing
Plans, credit packs & build costs
Modes Comparison
Legacy vs Heavy pipeline breakdown
Dashboard
Your projects & activity
New Project
Start building a new app
Account & Settings
Profile, security & billing
Refer & Earn
Share your referral link for credits
Billing
Manage your subscription & credits
Resources
Guides, tutorials & more
About Atai
Our mission and story
Getting Started
Atai is the AI business-building platform. You give it a starting point — a business idea, a competitor's website, or a GitHub repository — and it creates a complete, functional application you can collaborate on, refine, publish, and grow into a real business.
You don't need to know how to code. You don't need a technical co-founder. You don't need to assemble a team. Atai brings together an AI co-founder, specialist agents, product development, technology, and infrastructure so you can focus on the vision and the customers.
Watch a step-by-step walkthrough of getting started with Atai — from signing up to publishing your first application.
What you'll need
- A free Atai account
- A website address to mirror, or an idea to build from
- Credits for building (new accounts start with 500 free credits)
Your journey from idea to business
Create an account
Sign up with your email or Google account. You get 500 free credits to start — no credit card required.
Choose your starting point
Describe your business idea using the Founder Form, paste a competitor's URL, or link a GitHub repository.
Atai analyses and plans
Atai reads your input, understands the product, and creates a complete structured app plan.
Collaborate & refine the plan
Review your plan on the Collaborate page. Chat with the AI to adjust features, flows, and business model before anything is built.
Submit and build
Once you're happy with the plan, click Submit. Atai builds the full application — frontend, backend, database, auth, and infrastructure.
Launch
One click publishes your app to a free subdomain or your own domain. HTTPS, CDN, and global hosting included.
Operate
Manage your customers, product, data, payments and business from the Atai dashboard.
Grow
Improve the product, acquire customers, experiment, and keep building as your business scales.
How It Works
Atai works in three stages: Understand, Plan, and Build.
Understand
Atai reads your starting point — a website or idea — and figures out what it is, what it does, and how it's structured.
Plan
It creates a detailed blueprint of the application: screens, features, data, and design direction. You review and edit this before anything is built.
Build
Once you approve the plan, Atai generates a complete, working application with a real frontend, backend, and database.
The key difference from other tools is that Atai understands the full picture before building. It doesn't just generate screens — it creates a complete application with working data, user accounts, and real functionality.
Atai Standard & Pro Modes
Atai offers two pipeline modes when generating your application. You choose the mode when creating a new project — it controls how deeply the AI analyses, plans, and builds your app.
Atai Standard
Fast · efficient pipeline
- 30–60 second processing
- 5 credits for scrape + 5 for planning
- 25k / 50k / 75k credits for builds
- Good for prototypes and most applications
- Single-pass specification generation
Atai Pro
Premium · 7-stage pipeline
- 2–5 minute processing
- 100 credits for scrape + 100 for planning
- 50k / 75k / 100k credits for builds
- Research, critique, repair & validation stages
- Up to 200% better output quality
The 7 Pro mode stages
Understanding
Deep analysis of your website or idea
Research
Detects missing features, security gaps & best practices
Planning
Generates a comprehensive application specification
Critique
Independent quality review of the plan
Repair
Fixes issues found during critique
Validation
Ensures the spec is complete and consistent
Sanitization
Final cleanup and optimisation
Want a full side-by-side comparison? View the Modes Comparison page →
Website Mode
Website Mode lets you point Atai at any live website and turn it into a working application. This is the most popular way to start.
How to use Website Mode
- Go to your dashboard and click New Project
- Select Mirror a Website
- Paste the website address you want to mirror
- Choose your analysis mode:
- Relevant Info — Atai analyzes the most important pages, understands the product, and creates a custom plan. Best for most projects.
- Deep Crawl — Atai crawls the entire website, collects every page, and builds an exact replica. Best when you need the whole site preserved.
- Review the analysis and plan that Atai creates
- Edit anything you want, then click Build
What Website Mode analyzes
When Atai analyzes a website, it looks at:
- Pages and navigation — the structure, menus, and how pages connect
- Design and layout — colors, fonts, spacing, and visual patterns
- Features and functionality — what the site does, user flows, and interactive elements
- Content and copy — text, images, and media across the site
- Data patterns — what kind of information the site stores and displays
Website Mode works best with
- Marketing websites and landing pages
- Application dashboards and admin panels
- E-commerce storefronts
- Portfolio and showcase sites
- SaaS product interfaces
Idea Mode — Founder Form
Idea Mode lets you start from a business description instead of a website. Rather than a single free-text box, Atai uses a structured Founder Form — five fields that help the AI generate a far more accurate and relevant app plan.
The five fields
Business / product name
What you want to call your product. Optional — you can name it later.
The problem you are solving
RequiredDescribe the pain or gap your business addresses. This drives the whole plan.
Your target audience
Who the product is for — freelancers, small businesses, students, etc.
The solution
RequiredHow your product solves the problem. Plain language is perfect.
Business model
How you plan to make money: SaaS subscription, One-time purchase, Marketplace / commission, Free with paid upgrades, or Other.
Why structured fields matter
The business model field is especially important — it tells the AI whether to scaffold payment flows, subscription logic, marketplace commission handling, or free-tier upgrade gates. The more context you provide, the better the plan.
How to use Idea Mode
- Go to your dashboard and click New Project
- Select Start from an Idea
- Fill in the Founder Form — at minimum the Problem and Solution fields
- Click Generate app plan
- Atai takes you to the Collaborate page to review and refine before building
Collaborate & Refine Your Plan
After analysis completes — for any mode (Idea, Website, or GitHub) — Atai transitions your project to Plan Ready state instead of launching the build immediately. This gives you a chance to review and refine the plan before any credits are spent on the build.
No credits are charged until you click "Submit Plan & Start Building"
Analysis credits are charged when the plan is generated. Build credits are only reserved when you explicitly approve and launch the build from the Collaborate page.
The Collaborate page
The Collaborate page is a split-view interface:
Left panel — Your plan (60%)
- What is being built
- Who the app is for
- Key features
- How users will use the app
- Data the app manages
- How users sign in
- Runtime & Integrations — the Atai capabilities your app will use (AI, messaging, payments, and more)
- Your recorded project preferences
Written in plain business language — no technical jargon.
Right panel — AI Chat (40%)
Chat directly with the AI to refine the plan before building:
- Ask questions about what will be built
- Request changes to features or flows
- Adjust the business model
- Add or remove functionality
- The plan updates in real time
Runtime & Integrations — the plan-to-SDK connection
When you describe a feature that needs AI, messaging, payments, search, maps or similar, the AI plans it in Atai's own capability vocabulary and writes it into the Runtime & Integrations plan section. That section isn't just documentation — the build honors it: the generated application is wired to the official @atai-group/sdk with a project-scoped runtime API key (ATAI_API_KEY) provisioned automatically, so the features you planned actually call Atai. Curious what your app can call? Read the Atai SDK & Runtime API reference →
How to reach the Collaborate page
- After analysis completes, the project enters Plan Ready state
- A Review plan button appears in the project workspace header
- Click it to open the Collaborate page
- Chat with the AI to refine the plan as much as you need
- When satisfied, click Submit Plan & Start Building
You can also access the Collaborate page at any time via the workspace action buttons at the top of your project page.
Understanding & Planning
After Atai analyzes your starting point, it creates a detailed application plan. This is the most important step — it's where Atai figures out exactly what your application needs.
What the plan includes
Application Type
What kind of application this is — a marketplace, a dashboard, a portfolio, etc.
Purpose
A clear description of what the application does and who it's for.
Features
A checklist of capabilities — authentication, dashboards, payments, file uploads, and more.
Data Model
What information the application stores — users, products, orders, and how they relate.
User Flows
Step-by-step paths users take through the application.
Design Direction
Colors, fonts, layout style, and visual approach.
You can review and edit every part of this plan before building. Nothing gets built until you say it's ready.
Editing Your Plan
The plan Atai creates is a starting point — not a final answer. You can change anything before building.
What you can edit
- Enable or disable features — turn on payments, admin panels, file uploads, or any other capability
- Add or remove data types — define what information your application stores
- Change the design direction — update colors, fonts, and visual style
- Modify user flows — change how users move through the application
- Add custom instructions — tell Atai about specific requirements or preferences
After editing, Atai will update the plan to reflect your changes. You can go back and forth as many times as you need.
Building Your Application
When you click Build, Atai generates your complete application. This usually takes a few minutes.
What gets built
Your application includes everything it needs to work:
What happens after building
Once the build is complete, you can:
- Preview your application in a live environment
- Open the source code and make changes directly
- Send instructions to continue building and adding features
- Publish to a web address for anyone to access
Database Manager
Every application Atai builds comes with a live database. The Database Manager lets you browse tables, view records, create new entries, edit existing ones, and delete data — all without touching code or writing SQL.
How to access the Database Manager
- Open any built project from your dashboard
- Click the Database button in the project header
- You'll see all the tables your app uses, with their field schemas
- Click any table to browse and manage its records
What you can do
Browse Tables
See all your database tables with their field types, relations, and record counts.
View Records
Paginated grid view of all records. Supports filtering by any field and sorting in either direction.
Create Records
Add new rows directly from the browser — no code needed. All field types are supported.
Edit Records
Click any row to edit its fields inline. Changes are saved immediately to the live database.
Delete Records
Remove individual records with a confirmation step to prevent accidental deletions.
Schema View
See field names, types, and relationships. Understand your data model at a glance.
Field types
The database manager displays every field type with its own colour and icon so you can instantly tell what kind of data each column holds:
The Database Manager is available at /project/[id]/database for any project that has been built.
Working With Your Application
After your application is built, the workspace gives you full control. You can keep building, modify the code, or send instructions to add new features.
The workspace includes
- Live preview — see your application running in real time
- Source code viewer — browse and edit the generated code
- Instruction bar — describe changes you want and Atai will implement them
- Database manager — view and manage your application's data directly
- Deployment controls — publish, unpublish, and manage your live application
Sending instructions
Use the instruction bar to describe changes in plain language. Atai will implement them for you. Some examples:
Publishing & Domains
Once your application is ready, you can publish it to the web so anyone can access it. Atai offers two publishing options.
Free Subdomain
Every published application gets a free web address at yourapp.totalum-project.com. This is free forever, includes automatic security (HTTPS), and works instantly — no setup required.
Custom Domain
Connect your own domain name (like yourapp.com) for a professional, branded experience. You'll need to update a few settings at your domain provider — Atai walks you through it step by step.
How to publish
- Open your project and click Publish
- Choose between a free subdomain or a custom domain
- For custom domains, follow the DNS setup instructions
- Your application goes live within minutes
Credits & Billing
Atai uses a credit system. Credits are spent when Atai analyzes websites, generates plans, and builds applications.
How credits work
- Subscription & permanent credits — monthly plans plus one-time credit packs
- 500 free credits — every new account starts with credits to try Atai
- Buy more anytime — purchase permanent credit packs or subscribe via Dodo Payments
What costs credits — Legacy mode
What costs credits — Heavy mode
See full plan pricing, credit packs, and hosting options on the Pricing page → or compare modes on the Modes Comparison page →
Build cost tiers
Atai automatically classifies your project into one of three tiers based on the complexity of its specification:
- Simple — straightforward apps with basic pages and minimal logic
- Medium — multi-page apps with authentication, data models, and dashboards
- Complex — advanced apps with multiple features, integrations, admin panels, and payments
Themes & Appearance
Atai supports five visual themes. Your preference is saved automatically and synced across devices when you're signed in.
System
DefaultFollows your OS preference — dark when your OS is dark, light when it's light.
Dark
True neutral dark background. High contrast, easy on the eyes in low light.
Light
Clean pure-white background. Great for bright environments.
Light Blue
Soft blue-tinted light theme. A cooler alternative to plain white.
Glass
VisualGlassmorphism — translucent, frosted-glass surfaces with backdrop-blur. Vivid and modern.
How to change your theme
- Click the theme icon button in the top navigation bar (any page)
- Select your preferred theme from the dropdown
- The theme applies instantly — no page reload needed
- Or go to Settings → Appearance for a full preview of each theme
Theme persistence
- Saved to
atai:themein your browser localStorage immediately - Synced to your account in the database when signed in
- Loaded from your account on next login — works across devices
Account & Settings
Managing your account
- Profile — update your name, profile picture, and display preferences
- Security — change your password, manage active sessions, and update your email
- Billing — view your credit balance, transaction history, and top up credits
Refer and earn
Invite friends to Atai and earn bonus credits. When someone signs up using your referral link and becomes an active user, you both receive credits. Share your referral link from the Refer & Earn page in your account menu.
GitHub Integration
Connect your GitHub account to unlock powerful version control features for your Atai projects. GitHub integration enables automatic code pushing and building from existing repositories.
What is GitHub integration?
GitHub integration allows you to link your Atai projects with your GitHub repositories. Once connected, you can:
- Auto-push to GitHub — Automatically push your built application code to a GitHub repository after each successful build
- Build from existing repos — Use an existing GitHub repository as the source for AI analysis and application generation
- Version control — Track all changes to your project code with full git history
- Team collaboration — Share your code with team members or contributors through GitHub
How to connect GitHub
Step 1: Connect your GitHub account
- • Go to Settings → Profile
- • Scroll to the Connected Services section
- • Click Connect GitHub
- • Sign in with your GitHub account and authorize Atai
Step 2: Enable integration for a project
- • Open any project workspace
- • Click the GitHub button in the top action bar
- • Choose your integration mode (see below)
- • Select or create a repository
- • Click Connect
Integration modes
📤 Push to GitHub (Auto-push mode)
Automatically push your built application code to a GitHub repository after each successful build. Perfect for:
- • Backing up your code
- • Tracking changes over time
- • Deploying to external hosting (Vercel, Netlify, etc.)
- • Sharing with team members
📖 Build from repo (Source mode)
Use an existing GitHub repository as the starting point for AI analysis. The AI will:
- • Read your README and code files
- • Analyze your application structure
- • Generate a specification based on your existing codebase
- • Build or enhance the application
Great for migrating existing projects or building on top of starter templates.
Managing your repositories
When connecting GitHub, you can:
- • Select from your existing GitHub repositories
- • Create new repositories directly from Atai
- • Choose which branch to push to (default: main)
- • View push history and commit links
- • Disconnect at any time
Benefits of GitHub integration
✓ Version History
Track every change with full git commit history
✓ Collaboration
Share code with team members effortlessly
✓ Backup & Safety
Your code is safely stored on GitHub
✓ External Deployment
Deploy to Vercel, Netlify, or any git-based host
Frequently asked questions
Do I need a GitHub account?
Yes. You need a free GitHub account to use this feature. Sign up at github.com/signup
Can I use private repositories?
Yes. Atai supports both public and private repositories. Your code remains private if your repository is private.
What happens if I disconnect?
Disconnecting stops future auto-pushes but doesn't delete any code already in your GitHub repository. Your git history remains intact.
Can I connect multiple projects to the same repo?
Yes, but we recommend using different repositories or branches for each project to avoid conflicts.
Frequently Asked Questions
Do I need to know how to code?
No. Atai handles all the technical work. You describe what you want, review the plan, and click build. If you do know how to code, you can also edit the generated code directly.
What kind of applications can Atai build?
Atai can build a wide range of web applications — dashboards, marketplaces, portfolios, admin panels, booking systems, content platforms, and more. If it has a user interface and stores data, Atai can build it.
Can I edit the application after it's built?
Yes. You can edit the source code directly, or use the instruction bar to describe changes in plain language. Atai will implement them for you.
How long does it take to build an application?
Most applications are built within a few minutes. The analysis and planning stage takes 30-60 seconds, and the build itself usually takes 1-3 minutes depending on complexity.
Can I connect my own domain name?
Yes. After publishing, you can connect any domain you own. Atai provides step-by-step instructions for updating your domain settings.
Is my data secure?
Yes. Atai uses industry-standard encryption for all data. Your account is protected with secure sessions, and your application data is stored in encrypted databases.
What happens if I run out of credits?
You can top up your credits at any time via Mobile Money. Your existing projects and applications remain accessible — you just need credits to build new ones or make changes.
Can I export my application?
Yes. You can view and download your application's source code from the workspace. The code is yours to use however you like.
Does Atai work on mobile?
Atai is designed for desktop use. The applications it builds are fully responsive and work great on mobile devices.
What is the difference between Website Mode and Idea Mode?
Website Mode starts from an existing website — Atai analyzes it and builds something based on it. Idea Mode starts from a description — you tell Atai what you want, and it creates a plan from scratch.
Ready to build?
Start with 500 free credits. No credit card required.
Explore more
SDK & API Reference
The @atai-group/sdk and Runtime API — keys, endpoints, capabilities
Developer Portal
Build with Atai's infrastructure — AI, payments, maps, and 40+ services
Pricing & Credits
Plans, credit packs, and what every action costs
About Atai
Our mission, team, and the story behind the platform