Skip to main content
Version: Next

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:

Git - Downloading Package
Git - Downloading Package favicon 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 12 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.

success

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:

GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions
Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions - GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active nod...
GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions favicon https://github.com/nvm-sh/nvm
GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions

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

GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.
A node.js version management utility for Windows. Ironically written in Go. - GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.
GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go. favicon https://github.com/coreybutler/nvm-windows
GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.
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:

Yarn
Fast, reliable, and secure dependency management.
Yarn favicon https://classic.yarnpkg.com/lang/en/docs/install
Yarn

Install Smartface IDEโ€‹

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

Releases ยท smartface/smartface-ide-releases
Smartface ide releases. Contribute to smartface/smartface-ide-releases development by creating an account on GitHub.
Releases ยท smartface/smartface-ide-releases favicon https://github.com/smartface/smartface-ide-releases/releases
Releases ยท smartface/smartface-ide-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 and .deb formats.

success

Smartface recommends to use Appimage format, even if you are using Debian 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:

GitHub - TheAssassin/AppImageLauncher: Helper application for Linux distributions serving as a kind of "entry point" for running and integrating AppImages
Helper application for Linux distributions serving as a kind of &quot;entry point&quot; for running and integrating AppImages - GitHub - TheAssassin/AppImageLauncher: Helper application for Linux d...
GitHub - TheAssassin/AppImageLauncher: Helper application for Linux distributions serving as a kind of "entry point" for running and integrating AppImages favicon https://github.com/TheAssassin/AppImageLauncher
GitHub - TheAssassin/AppImageLauncher: Helper application for Linux distributions serving as a kind of "entry point" for running and integrating AppImages

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.