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

# Getting started

DataFlow is an internal tool builder. You can build your internal tools fast and simply in less than five minutes.

## 1. Create a workspace.

The workspace is a space where we store apps and projects, every team should have a workspace to separate the work. You can create a new workspace by clicking the + button at the top right of the left sidebar.<br>

<figure><img src="/files/gzlJ9CFStaZFsKEH0Pct" alt=""><figcaption><p>new workspace</p></figcaption></figure>

## 2. Create a project.

The project is where you create, design, and publish your apps.

<figure><img src="/files/C4dAQaarJkYJ6LaDbdmh" alt=""><figcaption><p>new project</p></figcaption></figure>

## 3. Create a board and design an app.

Now we can create a board. Boards are a single page where you can lay out components.  After creating the aboard, let's add a button and an input into a board.

<figure><img src="/files/0IuK50MOoCtIAd2T5JMt" alt=""><figcaption><p>create a button and an input</p></figcaption></figure>

## 4. Add an adapter.

Adapters are the backbone of the components. It handles events, queries and modifies component attributes at runtimes. \
\ <br>

<figure><img src="/files/417DGm1I9vMzNKfxVgyO" alt=""><figcaption><p>create an adapter</p></figcaption></figure>

After creating an adapter, we can add a script that controls the UI components.

<figure><img src="/files/ReNg6esWRF6CclpyioaM" alt=""><figcaption><p>write adapter script</p></figcaption></figure>

## 5. Connect a component to an adapter.

We can connect a UI component to an adapter to handle its events. For example, we can connect the button click event to the adapter we just created in the step above.

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

## 6. Build test and publish.

After settings up, click the Build button (the triangle button on the toolbar) and check out the result.

<figure><img src="/files/S0D1wUUn9zOSWmCMBTdr" alt=""><figcaption><p>build test</p></figcaption></figure>

Click the home button on the header tab, and you will see the publish button. Click that button to publish the app.

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