---
tags: ULA-EN
disqus: hackmd
title: Install | ULA
description: step-by-step guide how to install and run the app template on your computer
image: https://i.imgur.com/85X6yNT.png
---

# Install

ULA is an application template that does not require programming skills. Still, you should initially

* install a few programming tools
* use a few commands from the command prompt (terminal)

## Node, Git, VS Code

Please, visit links below and install:
- [Node](https://nodejs.org/) (choose latest v16 or newer)
- [Git](https://git-scm.com/downloads)
- [VS Code](https://code.visualstudio.com/)

Create a folder for your app and open it with VS Code.
<small>Right mouse click on folder --> open with --> VS Code</small>

Open Terminal (Command Prompt): Ctrl+\`
<small>or `Top menu --> View --> Terminal`</small>

Check that your Terminal works and everything has been installed correctly by executing the following commands:
<small>type them, or copy/paste to Terminal, then press `Enter`</small>

git --version
node --version 
code --version 

You will see their versions.

## Expo-cli

npm install -g expo-cli

:::warning
<small>:page_facing_up: for more info: [expo-cli](https://docs.expo.io/workflow/expo-cli/)</small>
:::

## ULA

Execute the following commands in the terminal (copy, paste, press Enter):

git clone https://github.com/Aparus/ULA.git .  
git clone https://github.com/Aparus/ula-content-example.git content  
npm install
npm run generate-assets  
expo start --web

What do those commands do?
1. clone (download) template of the app from git to your project folder
1. clone (download) content example folder from git
1. install all software (dependencies) needed for running the app
1. convert human-readable text from `/content` folder to machine-readable code to `/assets` folder
1. start the app

:tada: Congratulations. We hope you see the app running on your computer.

## Troubleshooting

If you have any problems during the installation process:
- delete everything from the project folder (because it was installed partly and incorrectly),
- repeat [Install ULA](#ULA) process step-by-step, by executing only one command at a time (copy/paste one line and press `Enter`), then you understand exactly what error appears and where.

When you see an error:
- google it and try to fix
- visit [our forum](https://github.com/Aparus/ULA/issues) and seek similar problems
- if you can't solve a problem by yourself, please [open an issue](https://github.com/Aparus/ULA/issues/new) on our forum (i.e., GitHub page of ULA repository)

{%hackmd tKQW1R4oSvSm58CCiq1f-Q %}