# Installation

# Prerequirements

- [ ] [Visual Studio Code](https://code.visualstudio.com/download)
- [ ] [Docker Desktop](https://www.docker.com/products/docker-desktop)

# Setup

## Install `Dev Container` Extension
Just search in Marketplace for `Dev Containers` from `Microsoft` developer

## Check Docker Desktop Resources available
There should be at least:

CPUs: 4
RAM: 8.0 GB

## Copy .env file

Run `Terminal` in project root folder and execute the following command:

cd .devcontainer && cp .env.example .env

## Build and Run in Container (cold start)
Open Command Palette (`CMD + Shift + P`) and type `Rebuild and Reopen` then select `Dev Containers: Rebuild and Reopen in Container`

### After building Container (warm start)
There will be another option available named `Reopen in Container` and a simple notice about that with the same button

## Wait for installation to complete
You could check installation progress by clicking on status title (`Reading Dev Container Configuration`)

There will be a lot of logs about downloading Docker images and then installing third-party dependencies with `yarn` etc.

After that message integrated terminals could be closed

## Start development environment
Open new integrated terminal and start development environment by typing `yarn start`

It will start (after a while):

:3000 — backend     (main web app contains API and processing through workers)
:3001 — frontend    (simple react app that calls backend with graphql)
:3002 — docs        (static pages built with vitepress)

Available in your host's network with `localhost` address

## Login with demo account
Open page at `localhost:3001` and login using following credentials:

login: [e-mail]
password: sample


# Flow (example)

## Create a new Flow
Just by clicking on placeholder container with `+` sign or `Create flow` button at the top-right corner

## Add a Webhook Trigger
Search for `Webhook` application in the list of available triggers

Configure it and copy Webhook URL

## Call webhook trigger
Open Terminal and by using `curl` utility "call" the copied URL

Now we should press `Test & Continue` and see the sample data passed from `curl` previously. We could pass any kind of data with `POST` method and `body` from `curl` utility

## Perform actions
Do anything you want with available apps. The webhook trigger one of the most simplest way to test apps and call Flows. Just because you have full control of input data and calls.

## Publish Flow
To be able to call full Flow execution process it should be published

## Executions
The list of Flow executions (including passed data and output results) could be found at corresponding page

# Application development

- [Application development in details](https://automatisch.io/docs/build-integrations/folder-structure)