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

# Quick Start

Let's start with a simple user interface to browse and manage your flows.

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FcHuy8JlpCHyE2UJzL7hL%2Fflow-manager-light.png?alt=media&amp;token=61f37b64-dca2-4eb4-a672-a444dad671e2" alt=""><figcaption><p>Flow Manager</p></figcaption></figure>

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2F145GIsUmKqzzqzHHN4dd%2Fdesigner-light.png?alt=media&amp;token=2159f488-e3dc-48cd-a845-0a25c3134ce4" alt=""><figcaption><p>Designer</p></figcaption></figure>

Create the `html` demo below and follow the steps ahead to learn the essentials.

```markup
<html lang="en">
<head>
  <meta charset="UTF-8">
  <script src="https://my.YOURTENANT.appmixer.cloud/appmixer/appmixer.js"></script>
</head>
<body>
  <div id="flow-manager"></div>
  <div id="designer"></div>

  <script async type="module">
    const appmixer = new Appmixer()

    appmixer.set('baseUrl', BASE_URL)

    try {
        const auth = await appmixer.api.signupUser(USERNAME, PASSWORD)
        appmixer.set('accessToken', auth.token)
    } catch (error) {
        alert(error)
    }

    const flowManager = appmixer.ui.FlowManager({ el: '#flow-manager' })
    const designer = appmixer.ui.Designer({ el: '#designer' })

    flowManager.on('flow:open', flowId => {
        flowManager.close()
        designer.set('flowId', flowId)
        designer.open()
    })

    flowManager.open()
  </script>
</body>
</html>
```

1. Get `Appmixer` constructor from `appmixer.js` file and create a new instance:

```html
  <script src="https://my.YOURTENANT.appmixer.cloud/appmixer/appmixer.js"></script>
```

```javascript
const appmixer = new Appmixer()
```

2\. Set `baseUrl` to connect the API module to the REST API of your engine:

```javascript
appmixer.set('baseUrl', BASE_URL)
```

3\. Create a new user and set `accessToken` to authorize your `appmixer` instance:

```javascript
const auth = await appmixer.api.signupUser(USERNAME, PASSWORD)
appmixer.set('accessToken', auth.token)
```

Change `USERNAME`(e.g. `example@domain.com`) and `PASSWORD`(e.g. `12345678`) parameters to valid credentials for registration of a new user. Or use an authentication method if the user already exists:

```javascript
const auth = await appmixer.api.authenticateUser(USERNAME, PASSWORD)
```

{% hint style="info" %}
`The`token is used by Appmixer to identify the user. Store the token and credentials in a database of your product. This way, you can always associate your users with the (virtual) ones created for Appmixer.
{% endhint %}

4\. Create new instances of **Flow Manager** and **Designer** widgets:

```html
<div id="flow-manager"></div>
<div id="designer"></div>
```

```javascript
const flowManager = appmixer.ui.FlowManager({ el: '#flow-manager' })
const designer = appmixer.ui.Designer({ el: '#designer' })
```

5\. Open **Flow Manager** to browse the flows and switch to **Designer** when a flow is selected:

```javascript
flowManager.open()

flowManager.on('flow:open', flowId => {
    flowManager.close()
    designer.set('flowId', flowId)
    designer.open()
})
```


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.appmixer.com/6.0/v4.5/appmixer-sdk/getting-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
