# TilBuci desktop app project

This is your Electron project. It can be used to create Windows, Linux and macOS apps for both x64 and ARM platforms on all systems - just follow the procedure below in the system where you want to create your app for. If you have already generated apps from your movie using Elactron, just copy the new files, overriding the previous ones. Avoid saving your Electron project on a folder with spaces of special characters on path/name.

You can check out a video tutorial with this procedure at https://www.youtube.com/watch?v=NFs9FwbQTac .

# Preparing your system

Before creating mobile apps for the first time, you need to prepare your system for this task. You only need to follow this stes once: install the latest version of Node.js — to do this, go to nodejs.org and follow the recommended installation procedure for your operating system.

Remember: this step should only be performed the first time you create an app. It can be ignored for future ones.

# Setting up your app

With your system ready, you'll need to configure your new app. To do this, simply run the setup script according to your system ("windows-setup.cmd", "linux-setup.sh"* or "macos-setup.sh"*). This script may take some time to complete. You only need to run it once per app you want to create.
*If you are creating Linux or macOS apps, you may need to enable the execution of these scripts files before runing them (usually by calling "chmod +x script-name.sh" on your terminal).

# Testing your app

To test your app, simply run the script according to your system "windows-testapp.cmd", "linux-testapp.sh" or "macos-testapp.sh"). After a preparation process that may take some time, the app will open, displaying your creation.

# Creating the app

After testing, it's time to create your app's executable. To do this, run the script "windows-createapp.cmd", "linux-createapp.sh" or "macos-createapp.sh"). This process may take a while, and when finished, the folder where your app was saved will open - notice that both x64 (on macOS, "Intel") and ARM (on macOS, "Silicon") versions of the app are created. All files within these folders are necessary if you plan to distribute your creation this way.

# Making an installer (Windows and macOS only)

If you prefer to distribute your creation as an installer, run the script "windows-createinstaller.cmd" or "macos-createinstaller.sh". When the process is complete, which can take a while, the folder containing your installer will open (it's inside "make", for both x64 and ARM platforms). To distribute, simply forward the "setup" file — the other files found in this folder are not necessary.

There are several software packaging formats available for Linux ("deb", "rpm", "Flatpack" and so on), not all of which are compatible with all distributions. For this reason, an installer creation script is not provided for this system — some technical knowledge may be required to create the install package in the chosen format.

# Where to go from here

These instructions cover the basics of building desktop apps from content created in TilBuci, but the Electron platform has many other features. To learn more, visit the documentation at www.electronjs.org/docs/latest/.