> For the complete documentation index, see [llms.txt](https://docs.taskade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taskade.com/taskade-genesis/genesis/getting-started.md).

# Getting Started

Build your first app with Taskade Genesis in 5 minutes: turn a plain-English prompt into a working app, then test, refine, and publish it.

**This guide takes you from an idea to a working business app in about 5 minutes.**

***

## What is Taskade Genesis?

Taskade Genesis turns one prompt into a working app. It makes the screens and connects them to your workspace. To change the app, you describe the change in plain English.

For the full model, read [Workspace DNA](https://docs.taskade.com/platform/workspace-dna.md).

{% hint style="info" %}
**You can start in two ways.** Build from a blank prompt, as this guide shows. Or clone a ready-made app from [Taskade App Factory](https://www.taskade.com/apps) or [Taskade's official App Kits](https://www.taskade.com/@taskade), then change it. Both ways open the same Taskade Genesis editor.
{% endhint %}

## Before You Start

### What You Need

* ✅ **A Taskade account**: [Sign up free](https://taskade.com/signup) if you do not have one.
* ✅ **AI credits**: Every paid plan includes AI credits. A new Free account starts with 0 AI credits. If your Free account never had AI credits, Taskade EVE shows **Pick a plan to start building** at your first prompt. On Free, you earn free AI credits with referrals and invites, and you can upgrade at any time.
* ✅ **No plan yet?** Clone a free app kit from the [Taskade App Factory](https://www.taskade.com/apps). A free kit clones at no cost, and the copy is yours to change. Some kits clone only on a paid plan or for a price. A change by prompt uses AI credits.
* ✅ **A business problem**: a task that takes too much of your time or annoys your customers.
* ✅ **5 minutes**: time to work on one problem.

### What You Can Build

At the end of this guide, you have a working app that you published. It can be a client portal, a tracker, or a dashboard. Taskade Genesis does the technical work. You decide what the app must do for your business.

### What You Learn

* How to turn a business problem into an app description
* How to build a complete app with Taskade Genesis
* How to test and improve your app
* How to share your app with customers or team members

***

## Step 1: Identify Your Business Problem (1 minute)

Think of one part of your business that does not work well. Taskade Genesis often solves problems like these:

### **Customer Frustrations**

* *"Customers keep calling to book appointments when we're busy"*
* *"People submit support requests through random channels"*
* *"Clients don't know the status of their projects"*

### **Team Inefficiencies**

* *"We lose track of inventory and run out of popular items"*
* *"Following up with leads happens inconsistently"*
* *"Important tasks fall through the cracks"*

### **Data Chaos**

* *"Customer feedback is scattered across emails and reviews"*
* *"I can't see which products are performing well"*
* *"Team performance data is hard to track"*

**Your turn:** Write down the ONE business problem that you want to solve first.

***

## Step 2: Craft Your App Description (2 minutes)

Turn your problem into a clear description. Use this formula.

### **The Magic Formula**

**WHO** uses it + **WHAT** they need to do + **WHAT** happens automatically

### **Template to Copy**

```
I run a [YOUR BUSINESS TYPE] and need [WHO WILL USE THIS] to [WHAT THEY NEED TO DO].

They should be able to [SPECIFIC ACTIONS THEY TAKE], and when they do, the system should [AUTOMATIC RESPONSES/ACTIONS].

I want to [HOW YOU'LL USE THE DATA] so I can [BUSINESS OUTCOME YOU WANT].
```

### **Real Examples**

**Restaurant Owner:**

```
I run a restaurant and need customers to submit feedback about their dining experience. They should rate food quality, service speed, and overall satisfaction on a 1-5 scale, plus leave optional comments and upload photos. When someone gives us 3 stars or lower, immediately alert our manager via Slack so we can follow up personally. I want to see all feedback in a dashboard so I can track trends and improve our service.
```

**Yoga Studio:**

```
I run a yoga studio and need clients to book classes online and pay in advance. They should see available class times, choose their preferred instructor, and pay a deposit. When someone books, send them a confirmation email with class details and add the appointment to our Google Calendar. I want to track which classes are most popular so I can schedule more of them.
```

**Consultant:**

```
I'm a business consultant and need potential clients to request proposals through my website. They should fill out their business challenges, budget range, and timeline, plus upload any relevant documents. When someone submits a request, send me an instant Slack notification and add their information to my CRM. I want to track which types of projects people request most so I can focus my marketing.
```

**Your turn:** Write your app description with the template.

***

## Step 3: Build Your App with Genesis (1 minute)

In this step, Taskade Genesis turns your description into a working app.

### **Access Genesis**

1. Log in to Taskade at [taskade.com/create](https://www.taskade.com/create).
2. Open your workspace home. It shows a prompt box at the center of the screen. A new account opens there right after sign-up.
3. Leave **Agent Mode** on. It is on by default. Taskade EVE then plans and builds the whole app.

To work on one part of the app later, turn **Agent Mode** off. Then pick a focus, such as **App** or **Projects**.

### **Generate Your App**

1. Paste your description into the prompt box.
2. Click the **Send** arrow, or press Enter.
3. Watch the progress. Taskade Genesis shows each part as it builds.
4. Wait about 60 to 120 seconds. A larger app takes more time.

### **What Genesis Creates**

Taskade Genesis builds four layers of your app:

* **📊 Projects**: databases that store your business data
* **🤖 AI Agents**: assistants that learn your business and help users
* **⚡ Automations**: connections to email, Slack, and other tools
* **🖥️ App UI**: the pages, forms, and dashboards that your users see

***

## Step 3.5: Add Context Files (Optional - 30 seconds)

**Give Taskade Genesis reference files.** Taskade Genesis reads the files that you upload. It uses them to learn your brand, your requirements, and your design choices.

### **Why Add Context?**

Reference files give Taskade Genesis better information:

* **🎨 Brand**: logos, color palettes, and style guides
* **📋 Forms**: your current forms or data structures
* **🖼️ Layout**: screenshots or mockups of the layout that you want
* **📊 Data**: examples of how you organize information

### **Adding Context Files**

1. After the build, open the chat with Taskade EVE beside the preview.
2. Drag files into the chat, or click the attachment button (📎).
3. Describe your change, and name the uploaded files.

**Example Prompt:**

```
"Update this contact form to match our brand guidelines. Use the colors and fonts specified in the uploaded PDF. Apply our logo to the header."
```

### **Types of Context Files**

| File Type           | Purpose         | Examples                            |
| ------------------- | --------------- | ----------------------------------- |
| **Brand Assets**    | Visual identity | Logos, color palettes, fonts        |
| **Reference Forms** | Data structure  | Forms, surveys, applications        |
| **Documents**       | Requirements    | Business rules, process flows, SOPs |

Screenshots of website designs also help Taskade Genesis with the layout.

### **File Upload Tips**

* **PDF files** are good for brand guidelines and documents.
* **Images** (PNG/JPG) are good for logos and screenshots.
* **Text files** are good for code snippets and requirements.
* **All uploaded files** go into the Media files of your workspace.
* **On the Free plan**, you can upload images only. Other file types need a paid plan.

***

## Step 4: Test Your App (1 minute)

When the build finishes, a bar shows the app name with **is ready**, for example **Customer Feedback Portal is ready**. The bar also has a **Publish** button.

The first clean build of a new app also goes live once at its own `your-app.taskade.app` address. That first version is unlisted. It is not in public listings, and search engines do not index it. If the app has a sign-in screen and you did not choose who can open it, the app stays a draft.

### **Preview Your App**

1. Click **Preview** to see your app.
2. Use the app as a real user does. For example, make a booking or submit feedback.
3. Fill in each form with realistic test data.
4. Look in your email and Slack for the automatic notifications.

### **Test Checklist**

* ✅ **User experience**: The app is easy to understand and use.
* ✅ **Phones**: The app works on phones and tablets.
* ✅ **Data capture**: The app saves the important information.
* ✅ **Automations**: The emails and notifications arrive.
* ✅ **File uploads**: Users can attach photos and documents.
* ✅ **File processing**: The automations use the uploaded files correctly.
* ✅ **Appearance**: The app looks finished and matches your brand.

### **Common First-Time Issues**

* **No notifications?** Look at the settings of your email or Slack integration. Slack and other premium integrations need a paid plan.
* **The form looks wrong?** Describe the visual changes that you want.
* **Fields are missing?** Tell Taskade Genesis which information to add.
* **An automation runs at the wrong time?** Tell Taskade Genesis when each action must occur.

***

## Step 5: Perfect Your App (30 seconds)

To change your app, describe the change in the chat.

### **Common Refinements**

**Visual Updates:**

```
"Make the submit button larger and green"
"Add our company logo at the top"
"Use our brand colors: blue (#4A90E2) and white"
```

**Functionality Changes:**

```
"Only send alerts for ratings below 3 stars instead of 4"
"Add a field for customer phone numbers"
"Send confirmation emails immediately after booking"
```

**Automation Tweaks:**

```
"Also post new bookings to our #appointments Slack channel"
"CC the office manager on all customer emails"
"Send me a daily summary of all submissions"
```

### **Making Changes**

1. Describe the change in plain English.
2. Send the message in the chat.
3. Wait for Taskade Genesis to make the change. This usually takes 10 to 30 seconds.
4. Test the change.

On a new app, Taskade saves each change as a draft. Visitors see a change only after you click **Publish** again. Until you do, the publish status says **Changes not live yet**. You can also roll back to an earlier version from the version history.

***

## Step 6: Share It!

Your app solves a real business problem. In this step, you put it in front of real users.

{% hint style="warning" %}
**Keep your API keys in the Secrets vault.** If your app calls external APIs, store each key in **App settings → Developer → Secrets**. Send the calls through the outbound proxy. Then no key ships in client code. Taskade Genesis stops a publish when it finds a secret in the code. Read [App Secrets](https://docs.taskade.com/taskade-genesis/space-apps-guide/app-secrets.md) for the steps.
{% endhint %}

### **Publishing Options**

1. **Private use**: Keep the app in your workspace for your team.
2. **Custom domain**: Publish on your own domain, for example `app.yourcompany.com`, on Pro and up.
3. **Community**: List your app in Taskade App Factory. To let others clone it, set **Let others clone** to **Free** or **Paid**.
4. **Public link**: Share one link with external users.
5. **Hosted Taskade MCP** (paid plans): Connect Claude, Cursor, or another MCP client to your workspace. You can then make projects, manage agents, and edit the source of your app from your IDE. Read [Hosted Taskade MCP](https://docs.taskade.com/developers/workspace-mcp/genesis-app-mcp.md).

### **Getting It Live**

1. Click **Publish** in the top-right corner.
2. Under **Who can open it**, pick one choice:
   * **Anyone with the link**
   * **Anyone with the password** (Pro and up)
   * **Each person signs in**, with their own account
3. Choose how people find the app:
   * **Public link**: share the link.
   * **Custom domain**: use your own address (Pro and up).
   * **Community**: turn on **Show in public listings** under **More options**.
4. Copy the link and share it with your audience.

{% hint style="info" %}
**Private customer data?** Sign-in confirms who a visitor is. It does not hide other rows by itself. Before you show private customer data, open **Publish**, pick **Each person signs in**, turn on **Private entries**, and pick the owner field. Then test with a second account.
{% endhint %}

### **Community Sharing Benefits**

If your app can help other businesses, share it with the community:

* **Taskade App Factory**: your app shows in the public gallery.
* **Clones**: with **Let others clone** on, other teams can clone your app and use it.
* **Reputation**: other builders see your work.
* **Feedback**: community reviews help you improve your app.

### **Professional Deployment**

For business use, you can add these options:

* **Custom domain**: `portal.yourcompany.com` instead of a random link (Pro and up)
* **Your brand**: turn off the "Powered by Taskade" badge (paid plans)
* **SSL**: automatic HTTPS
* **Global CDN**: fast loading in all regions

Share your app with others:

* **Post** about your app on LinkedIn, Twitter, Reddit, or another platform.
* **Show** the problem that you had and the app that solves it.
* Tag us @taskade. We like to see what you build.
* **Join** our community to see what other makers build.

***

## What people build in their first 5 minutes

Each of these apps started as one plain-English prompt:

### Restaurant feedback system

**Problem:** Reviews arrived on Google too late to act on.

**Prompt:** "I need customers to rate their dining experience and leave comments, with instant Slack alerts for any rating below 4 stars."

**What you get:** A live feedback form, a place to sort the answers, and real-time alerts. You see a low rating at once, not days later.

### Yoga studio booking

**Problem:** All bookings came by phone, and double bookings were common.

**Prompt:** "I need clients to book yoga classes online, pay deposits, and get calendar invites, with automatic confirmations."

**What you get:** An online booking flow with deposits, calendar invites, and automatic confirmations. Phone calls and double bookings stop.

### Inventory alerts

**Problem:** Stock was low before anyone saw it.

**Prompt:** "I need to track inventory levels and get email alerts when items drop below 10 units, with automatic reorder suggestions."

**What you get:** A stock tracker that sends you an email before an item runs out. It also suggests reorders.

***

## What's Next?

You built your first Taskade Genesis app. Use these two phases to do more with it.

### **Phase 1 — Build**

#### **Immediate Next Steps**

1. Share your app with real users and customers.
2. Look at the data that comes in and at how people use the app.
3. Ask for feedback on what works and what does not.
4. Improve the app from that feedback.

#### **Expanding Your App**

* **Add automations** that connect to more business tools.
* **Build related apps** for other business processes.
* **Teach team members** to build their own apps.
* **Upgrade** to get enterprise features when your team grows.

### **Phase 2 — Run it as a business**

Turn your 5-minute app into a business that you run.

* [**Run Your Business on Taskade Genesis →**](https://docs.taskade.com/run-your-business-on-genesis/run-your-business.md): the full track, from a working app to a live business
* [**Add login & roles →**](https://docs.taskade.com/run-your-business-on-genesis/run-your-business/add-login-and-roles.md): control access and give each user the right view
* [**Put it on your own domain →**](https://docs.taskade.com/taskade-genesis/space-apps-guide/custom-domains.md): publish on your own domain
* [**Go-live checklist →**](https://docs.taskade.com/run-your-business-on-genesis/run-your-business/go-live-checklist.md): last checks before real customers use the app

### **Learning Resources**

* [**Examples & Templates →**](https://docs.taskade.com/taskade-genesis/genesis/examples-and-templates.md): apps for your industry
* [**Best Practices →**](https://docs.taskade.com/community-and-sharing/community-and-sharing/best-practices.md): better prompts give better results
* [**Advanced Features →**](https://docs.taskade.com/taskade-genesis/space-apps-guide/advanced-features.md): more business features
* [**Troubleshooting →**](https://docs.taskade.com/community-and-sharing/community-and-sharing/troubleshooting.md): solutions to common problems

### **Get Help**

* **Help Center:** [taskade.com/learn/genesis](https://www.taskade.com/learn/genesis)
* **Video Tutorials:** [youtube.com/taskade](https://youtube.com/taskade)
* **Community:** [taskade.com/apps](https://www.taskade.com/apps)
* **Email Support:** <support@taskade.com>

***

## Quick Reference Card

Use this card for your next app.

### **The 5-Minute Process**

1. **Find the problem**: What annoys you or your customers?
2. **Write the description**: WHO + WHAT + AUTOMATIC ACTIONS.
3. **Build with Taskade Genesis**: Paste the prompt and click **Send**.
4. **Test the app**: Use each feature as a real user does.
5. **Improve and share**: Make changes, then publish.

### **Magic Formula Template**

```
I run a [BUSINESS TYPE] and need [USERS] to [ACTION].
They should [SPECIFIC STEPS], and when they do,
[AUTOMATIC RESPONSE]. I want to [DATA USAGE] so I can [OUTCOME].
```

### **Testing Checklist**

* ✅ The app is easy to use.
* ✅ The app works on phones.
* ✅ The app saves all the data correctly.
* ✅ The automations send the notifications.
* ✅ File uploads work, if your app needs them.

***

### Next steps

* Copy a working prompt: [Living System Examples & Templates](https://docs.taskade.com/taskade-genesis/genesis/examples-and-templates.md)
* Improve prompts: [Living System Best Practices](https://docs.taskade.com/community-and-sharing/community-and-sharing/best-practices.md)
* Publish professionally: [Custom Domains & Branding](https://docs.taskade.com/taskade-genesis/space-apps-guide/custom-domains.md)
* Fix common problems: [Living System Troubleshooting](https://docs.taskade.com/community-and-sharing/community-and-sharing/troubleshooting.md)

***

*Step-by-step guide on taskade.com/learn:* [*Create Your First App*](https://www.taskade.com/learn/genesis/first-app)*.*
