> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/design-your-app/create-and-manage-apps.md).

# Create and manage apps

An app brings tables, records, views, pages, and automations together for one process.

Create apps from workspace **Home**. Use **App settings** to manage an app’s details, access, and visibility.

## **Create an app**

Create an app from workspace **Home**. Use AI for a generated starting model, or create an empty app manually.

{% tabs %}
{% tab title="Create with Ninox AI" %}
{% stepper %}
{% step %}
**Start app creation**

<figure><img src="/files/AZfudQNsANuaYtdq2Ko0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Describe the app**

Describe the process, data, and relationships you need to manage. You can select a suggested prompt or use <i class="fa-wand-magic-sparkles">:wand-magic-sparkles:</i> **Improve message**.
{% endstep %}

{% step %}
**Review and refine the result**

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

Review the generated tables, fields, relationships, and dashboard. Refine the result as needed.
{% endstep %}

{% step %}
**Approve and open the app**

Click **Approve** to create the app. Open the new app from its tile on **Home**.
{% endstep %}
{% endstepper %}

For a guided first app with AI, see [Quickstart - create your first app](/getting-started/builder-getting-started/quickstart-create-your-first-app.md).\
For more AI guidance, see [Ninox AI](/builder-hub/ninox-ai/ninox-ai.md).
{% endtab %}

{% tab title="Create manually" %}
{% stepper %}
{% step %}
**Start app creation**

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

On workspace **Home**, click **Create app manually**.
{% endstep %}

{% step %}
**Set up the app**

Enter an app **Name**. Ninox generates the **Internal name** automatically.
{% endstep %}

{% step %}
**Choose an icon and color**

Click the icon beside the app name. Select a color and click **Confirm**. Then select an icon and click **Confirm**.
{% endstep %}

{% step %}
**Create and open the app**

Click **Create app**. Open the new app from its tile on **Home**.

<figure><img src="/files/UNwH8EScximgsyq4FGti" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

For a guided first app without AI, see [Your first app](https://app.gitbook.com/o/yI8eJ2eecPOm72cxYjt5/s/vgUdF91rY6UMBUb5r9Cl/builder-getting-started/set-up-your-ninox-manually/your-first-app).
{% endtab %}
{% endtabs %}

## **Manage app settings**

**App settings** lets you change an app’s name, internal name, icon, and color. You can also control access, hide the app or its navigation, and delete the app when needed.

You can open **App settings** from two places:

* On workspace **Home**, find the app card. Open the three-dot menu, then select **App settings**.
* Inside an app, click <i class="fa-gear">:gear:</i> **App settings** in the app navigation.

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

{% hint style="info" %}
Turn on **Builder mode** to show **App settings** in an app’s navigation.
{% endhint %}

### **Change app details**

Use the top section to update the app’s details.

* **App name** changes the name shown to users.
* **Internal name** is the app’s unique system identifier. Ninox generates it when you create the app.
* The icon picker lets you choose or remove an icon, select a color, or enter a custom color value.

Click **Update settings** to save your changes.

{% hint style="warning" %}
Change the **Internal name** carefully. Scripts or integrations may depend on it.
{% endhint %}

### **Manage access and visibility**

Use **Allow access to** to restrict the app to selected workspace or custom roles. Workspace admins always retain full access.

You can also control what users see:

* Turn on **Hide this app** to hide it from **Home**. Afterward, only admins can see it there.
* Turn on **Hide the navigation bar inside this app**. This hides the navigation bar whenever **Builder mode** is off.

Click **Update settings** to save your changes.

For role details, see [Manage workspace access](/builder-hub/manage-your-organization-and-workspace/organize-your-workspace/manage-workspace-access.md).

### **Delete an app**

Delete an app only when you no longer need its structure or data.

{% stepper %}
{% step %}
**Open App settings**

Open **App settings** from workspace **Home** or from inside the app.
{% endstep %}

{% step %}
**Delete the app**

Click **Delete app**. Complete the confirmation shown by Ninox.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Deleting an app permanently removes its structure and data.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ninox.com/builder-hub/design-your-app/create-and-manage-apps.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
