# Quickstart - create your first app

This quickstart shows you how to go from sign‑up to a working first version of your app in just a few minutes.

## **Sign‑up and complete the onboarding** <a href="#complete-the-onboarding-and-sign-up" id="complete-the-onboarding-and-sign-up"></a>

{% stepper %}
{% step %}

#### Open the sign-up page

Open [Ninox 4](https://go.ninox.com/signup/) and start the onboarding flow.
{% endstep %}

{% step %}

#### Create your account

Sign up with your email address and create a password. Or use one of the sign‑in options.
{% endstep %}

{% step %}

#### Answer the onboarding questions

Answer the questions shown during onboarding. These answers help Ninox tailor your workspace and suggestions.
{% endstep %}
{% endstepper %}

Once you finish onboarding, you land on the blank app creation screen, where you can start creating your first app, either by describing it to Ninox AI or by setting up your data model manually.

<figure><img src="/files/CkPJgHp81izNukyYWqUL" alt="Blank app creation screen"><figcaption></figcaption></figure>

## **Describe your app to the Ninox AI assistant** <a href="#describe-your-app-to-the-ninox-ai-assistant" id="describe-your-app-to-the-ninox-ai-assistant"></a>

{% stepper %}
{% step %}

#### Enter your app description

In the **Ninox AI assistant** panel, use the **Describe what you want to create** field.
{% endstep %}

{% step %}

#### Choose or improve your prompt

Select a pre-created prompt such as **Vacation planner** or **HR tracker**. Or enter your own prompt.

If the prompt is too vague, click **Improve message**. Use the refined version, then submit it.
{% endstep %}

{% step %}

#### Review the generated app structure

Ninox AI analyzes your description and generates:

* Tables, for example, "Employees", "Onboarding", "Absences"
* Fields for each table, such as "First name", "Email", "Start date"
* Relationships between tables
* A **Dashboard** page as the first entry in the app navigation
  {% endstep %}
  {% endstepper %}

You now have an automatically generated starting point for both your data model and your app structure.

<figure><img src="/files/zDir2ILNYUBsmqufsKBa" alt=""><figcaption></figcaption></figure>

## **Refine the generated data model** <a href="#refine-the-generated-data-model" id="refine-the-generated-data-model"></a>

You stay in full control of your data model. Use Ninox AI as a starting point and adjust them as needed.

### **Refine your prompt**

If the generated data model is not close enough to what you imagined:

{% stepper %}
{% step %}

#### Update your description

In the **Ninox AI assistant**, revise your prompt.

For example, add: “Integrate a separate table for Team Managers”.
{% endstep %}

{% step %}

#### Submit the improved prompt

Send the updated prompt to generate a new result.
{% endstep %}

{% step %}

#### Review the updated suggestions

Check whether the revised tables, fields, and relationships match your needs.
{% endstep %}
{% endstepper %}

<figure><img src="/files/1BQFKDT8XsjivB0qgDmZ" alt=""><figcaption></figcaption></figure>

### **Manually adjust tables and fields**

You can change any part of the data model at any time. You can edit or delete existing tables and fields created by AI.

#### **Create additional tables**

{% stepper %}
{% step %}

#### Start a new table

Click **Create table** in the top bar.
{% endstep %}

{% step %}

#### Enter a descriptive table name

Add a clear name in **Name**.

Clear names such as “Customer subscriptions” help Ninox AI suggest better fields.
{% endstep %}

{% step %}

#### Enable AI suggestions if needed

Keep **AI suggestions** enabled if you want Ninox to propose fields for the new table.
{% endstep %}

{% step %}

#### Review the suggested fields

Keep, remove, or add fields as needed.
{% endstep %}

{% step %}

#### Create the table

Click **Create table** to confirm.
{% endstep %}
{% endstepper %}

#### **Add new fields to an existing table**

{% stepper %}
{% step %}

#### Create a new field

Click **Create field** in the top bar.
{% endstep %}

{% step %}

#### Choose the target table

Select the **Target table**, for example, "Employees".
{% endstep %}

{% step %}

#### Enter the field details

Add a **Field name**.

Adjust the auto-generated **Internal name** if needed. The internal name is used in automations, so keep it stable and avoid special characters.
{% endstep %}

{% step %}

#### Choose the field type

Pick the **Field type** that best fits your data.

* **Standard fields**: Text, Multi‑line text, Number, Yes/no, Single‑choice, Multiple choice, File
* **Contact fields**: Email, Phone, URL, Location
* **Date and time fields**: Date, Date and time, Appointment, Time, Duration
* **Special fields**: Color, Icon, User
* **Relationship fields**: From-one relationship, To-one relationship
  {% endstep %}

{% step %}

#### Save the field

Click **Add field** or **Add another field**.
{% endstep %}
{% endstepper %}

You can always return to the data model later to add new fields, change types, or restructure tables as your app evolves.

## Create your app <a href="#create-your-app" id="create-your-app"></a>

{% stepper %}
{% step %}

#### Decide whether to use sample data

Keep **Use sample data** enabled if you want Ninox to create dummy records.\
This helps you see how the app behaves with realistic example data.
{% endstep %}

{% step %}

#### Create the app

When your data model is ready, click **Create app**.\
Ninox generates the first working version of your app.
{% endstep %}
{% endstepper %}

Do not worry about getting everything perfect now. You can adjust your tables, fields, relationships, and field types at any time.

You now have a solid first version of your app. The app navigation includes the generated tables and an autogenerated **Dashboard** as the first entry. The generated dashboard can include charts, stats, and other views based on your prompt and sample data.\
You are now ready to continue configuring views, forms, and automations.

<figure><img src="/files/AE3wcYAaBGkjBr0RtVde" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ninox.com/getting-started/builder-getting-started/quickstart-create-your-first-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.