Skip to main content
Version: 7.3.2

Installation of Smartface IDE

Smartface IDE depends on Node&Git to work properly, so make sure that those are installed within your system before installing Smartface IDE. The tools below are the bare minimum of the software that need to be installed:

  • Node
  • Git
  • Yarn

Install Git​

You can skip this section if you have already Git installed.

Git is a SVN system which every developer have huge benefit to know and utilize.

Linux​

Vast majority of Linux Distributions have git as installed by default. If not, use package manager of your distribution to install git.

Mac​

If your Mac has XCode installed, chances are git is already installed within your system. If not, you should need to Install Command Line Tools with the following command:

xcode-select --install

As an alternative, you can use homebrew to install git by this command:

brew install git

Windows​

You can install git by using official git installer on Windows:

https://git-scm.com/download/win

As an alternative, you can use chocolatey package manager to install git.

Go to this link and download the latest Smartface IDE release, depending on your Operating System.

Install Node​

If you already have Node installed on your system, you can skip this section. Smartface IDE requires Node 16 or higher to function.

We recommend nvm or n to install Node, since switching between multiple Node versions might become handy for every Javascript developer. You can obtain Node any way you like, make sure that it is recognizable by the system. It also makes the updates easier.

tip

To check if you have node installed on your system, type node -v on your Terminal.

For Linux/Mac, refer to official GitHub repository and follow the steps:

https://github.com/nvm-sh/nvm

For Windows, refer to the official nvm-windows repository and follow the steps:

https://github.com/coreybutler/nvm-windows

info

For Windows, you can also install Node by their official site. However, multiple version management will not be easy if you do that.

Install Yarn​

Smartface IDE also uses yarn as its node package management instead of npm . To Install it, simply follow official yarn documentation:

https://classic.yarnpkg.com/lang/en/docs/install

Install Smartface IDE​

Navigate to this URL to grab the latest version of the Smartface IDE:

https://github.com/smartface/smartface-ide-releases/releases

Install Smartface IDE on Windows​

When you are done downloading the .exe file, double click the installer and follow the installation wizard. When the steps are complete, Smartface IDE will be installed on your system.

Default Installed Directory: C:\Program Files\Smartface\Smartface

Install Smarface IDE on Mac​

When you are done downloading the .dmg file, double click the installer and simply drag\&drop Smartface IDE into the Applications folder. Then Smartface IDE will be installed on your system.

Default Installed Directory: /Applications/Smartface.app

Install Smartface IDE on Linux​

On Linux, we currently support .Appimage, .deb and .rpm formats.

tip

Smartface recommends to use Appimage format, even if you are using Debian or Fedora based systems.

Install via Appimage​

The Appimage is a Linux format that can open the binaries directly in any directory. In order to open Smartface directly:

  1. Download the appimage file
  2. Open a terminal at and redirect to the directory which the Appimage file is downloaded
  3. Type chmod +x ./Smartface-<version>.Appimage to enable the file to be executable
  4. Type ./Smartface-<version>.Appimage& and the Smartface App will open.

Smartface recommends to integrate the .Appimage files in your system, in order to access the app the way your DE (Desktop Environment) recommends.

info

Try to double-click the .Appimage file before installing anything. If your DE has a way to integrate them into your system, a prompt will show and guide you through the process.

[Optional] You can use AppImageLauncher external library to automate your .Appimage files to your system. Follow this link to install:

https://github.com/TheAssassin/AppImageLauncher

Since the .Appimage files are not "installed" unless you use an another tool, the installation directory will be wherever you want.

Install via deb​

If your Linux system is Debian derivative, you can also install Smartface IDE through .deb package which is included in the Smartface releases.

  1. Download the .deb package.
  2. Open a terminal at and redirect to the directory which the deb file is downloaded.
  3. Type sudo dpkg -i ./Smartface-<version>.deb and let the package manager install it in your system.

Now, you can access Smartface IDE in your application center which your DE uses.

caution

Please note that the update feature does not work on .deb installations.

The installation directory will differ through your distribution of choice.

Install via rpm​

  1. Download the .rpm package.
  2. Open a terminal at and redirect to the directory which the rpm file is downloaded.
  3. Type sudo rpm -i ./Smartface-<version>.rpm and let the package manager install it in your system.

Now, you can access Smartface IDE in your application center which your DE uses.