# Source: https://docs.hypermode.com/apps/create-app.md

# Create Your App

> Get started by creating your first App in Hypermode

Creating your first App in Hypermode is straightforward. This guide walks you
through the entire process from workspace creation to having a fully configured
app ready for development.

## Prerequisites

Before creating your app, ensure you have:

* A GitHub account
* Access to a repository (existing or new)
* Basic understanding of your app's requirements

## Getting started

To create your app, follow these steps in the Hypermode console. If you haven't
created a workspace yet, you'll need to do that first. Workspaces are where you
and your team manage all your apps and configurations.

<Steps>
  <Step title="Create your workspace">
    Start by going to [hypermode.com](https://hypermode.com) and creating your
    workspace. Workspaces are where you and your team manage all your apps.

    <img src="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=7c442fb185752cb0b5ad0eb3d5225e10" alt="Create workspace interface showing workspace name input field" width="3456" height="1984" data-path="images/apps/workspace-creation.png" srcset="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=280&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=e42f259d1fb7b7b0913b935c11b79d05 280w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=560&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=187d7e95ce773c416ce70da9db980a85 560w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=840&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=fb00282064e98df0e22cecc7b2ab04d0 840w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=1100&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=02df5eb7c6f2ed8cd87ce5fd9632f35a 1100w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=1650&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=7e10cdd0c791d709c72370297400c040 1650w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-creation.png?w=2500&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=747fdb2c3dcafdcc9cf1f45948e89f22 2500w" data-optimize="true" data-opv="2" />

    Enter a descriptive name for your workspace and click **Create workspace**.
    Choose a name that reflects your organization or project scope, as this becomes
    the container for all your apps.
  </Step>

  <Step title="Navigate to Apps">
    Once your workspace is created, you'll see the main dashboard. Click on **Apps**
    to start creating your first app.

    <img src="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=a9f2b8925719c7a830acaf585959bcc7" alt="Hypermode dashboard showing Apps option" width="3456" height="1984" data-path="images/apps/workspace-landing.png" srcset="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=280&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=63be7a5cab29739ada8ba767172afbbf 280w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=560&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=151557f1d73ceb64addc2bdb4cfdebc2 560w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=840&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=de5b08396ddb282a0d53f502759e2945 840w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=1100&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=5cc7cc59bbd9650be9faf844e75550bc 1100w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=1650&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=8f5f81111e4580a451e980af60564fdc 1650w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/workspace-landing.png?w=2500&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=bb90d190cd219d7ab74ba2f0a4e1c647 2500w" data-optimize="true" data-opv="2" />

    From the Apps section, you have options to create different types of apps or
    import existing ones.
  </Step>

  <Step title="Configure Your App">
    Click **Import your Modus app** to create a new app. This option works whether
    you're importing an existing Modus project or starting fresh.

    <img src="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=78352e04cf9ad6efa5369baabaab32a7" alt="Import Modus app configuration form with app name, GitHub repository, and location fields" width="3456" height="1980" data-path="images/apps/app-create.png" srcset="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=280&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=ade0791597bf7a10906610e6bc05d406 280w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=560&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=86873b4cfa6ecc7195afbcc471de1edc 560w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=840&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=98d87a149672526b28c58d6a03955218 840w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=1100&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=f04a1d228bd80423eac893a4ac7bb84a 1100w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=1650&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=9591aea8aa3437d21c72964d7e5f46f8 1650w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/app-create.png?w=2500&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=4907b923ad02ed09ae298bdac9d09a08 2500w" data-optimize="true" data-opv="2" />

    ### Define your app name

    Enter a descriptive name for your app. This can be used in your app's endpoint
    URL and throughout the Hypermode console.

    ### Connect to your GitHub repository

    You have two options:

    #### Option 1: use an existing repository

    * Select your repository from the dropdown
    * Ensure your repository has the proper Modus structure or is ready for app
      development

    #### Option 2: create a new repository

    If you don't have a repository yet, you can create one:

    <img height="200" src="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=5928f57c990cec94e1ddd714341ef5c3" alt="GitHub repository creation interface with repository name field" width="1458" height="892" data-path="images/apps/github-create.png" srcset="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=280&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=96814416e85aaa7b387c6e1b07ff8515 280w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=560&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=03b7f54a724a44c560802d8ee786942e 560w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=840&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=aeb92821991de057832d373bb1192f3d 840w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=1100&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=f957bed0579c1a2df5a121d6acf4c5a0 1100w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=1650&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=f427e2e42e39e5f34a0dacaa87236bc1 1650w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/github-create.png?w=2500&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=e9e5c6e094829c4d27716df906291f41 2500w" data-optimize="true" data-opv="2" />

    1. Choose the repository owner (your organization or personal account)
    2. Enter a memorable repository name
    3. Add an optional description
    4. Create the repository
    5. Return to the app configuration and select your newly created repository

    ### Deployment location

    Choose your preferred deployment region. This affects:

    * **Latency**: Choose a region close to your users
    * **Compliance**: Select based on data residency requirements
    * **Performance**: Consider where your external services are hosted
  </Step>

  <Step title="Complete App Creation">
    After filling in all the configuration details, click **Create App**. Hypermode
    then automatically:

    1. Sets up your app infrastructure
    2. Configures the GitHub integration
    3. Generates your app's endpoint and API key
    4. Prepares your development environment
  </Step>

  <Step title="Review your App configuration">
    Once created, you'll see your app's configuration panel:

    <img src="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=79432bc2b83f13fb86672a1bd19826d1" alt="App details panel showing endpoint, GitHub repository, and API key information" width="3456" height="1982" data-path="images/apps/console-app.png" srcset="https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=280&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=2e5d757e328082cf2d8f0c0fcb4b49b6 280w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=560&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=1bf9aa7198f21be86f0cad48a1856436 560w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=840&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=9d44729f910e2a630357978ade13d56b 840w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=1100&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=2e691d6c075d5b58cca9f44c9dc0eaf8 1100w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=1650&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=0a3ce779b9c66ddd997840bf63fa56be 1650w, https://mintcdn.com/hypermode/9QWuPyr_PIBFkocg/images/apps/console-app.png?w=2500&fit=max&auto=format&n=9QWuPyr_PIBFkocg&q=85&s=ef0085efb8f360729ac9d0bdd5d5e0bf 2500w" data-optimize="true" data-opv="2" />

    Your new app includes:

    ### Endpoint

    Your production GraphQL endpoint where your app is accessible:

    ```text
    https://your-app-name-workspace-id.hypermode.app/graphql
    ```

    ### GitHub repository

    The connected repository for automatic deployments. Any push to the main branch
    triggers a deployment.

    ### API key

    Your authentication key for accessing the app's API. Keep this secure and use it
    in your app headers:

    ```bash
    Authorization: Bearer YOUR_API_KEY
    ```
  </Step>
</Steps>

## Development Approaches

With your app created, you can choose between two development approaches:

### Code first development

* Use the Modus CLI locally
* Full control over app structure
* Traditional Git workflows
* See the [Develop guide](/apps/develop-app) for setup instructions

### Conversational development

* Use Threads for AI-assisted development
* Natural language app building
* Rapid prototyping and iteration
* See the Threads documentation for details

## Next steps

Now that your app is created:

1. **Set up local development** with `modus dev` (see
   [Develop guide](/apps/develop-app))
2. **Configure connections** to external services (see
   [Connect Your App guide](/apps/connect-app))
3. **Deploy your first version** by pushing to your repository (see
   [Deploy guide](/apps/deploy-app))

Your app is now ready for development. The GitHub integration is configured,
your endpoint is live, and you have everything needed to start building your
AI-powered app.

## Troubleshooting

**Repository not appearing in dropdown?**

* Ensure you have proper permissions to the repository
* Check that the Hypermode GitHub App is installed on your organization/account

**App creation failed?**

* Verify your repository is accessible
* Ensure the app name doesn't conflict with existing apps
* Check that all required fields are filled correctly

**Need to change configuration?**

* Most settings can be updated later in the app's configuration panel
* Repository connections can be modified in the app settings