Getting Started
This guide will walk you through setting up your development environment, building, and running the Trufos application.
Prerequisites
- Node.js: Version v22.15.1is specified in the.nvmrcfile. It’s recommended to use a Node version manager like nvm to manage Node.js versions.nvm use
- Yarn: A recent version of Yarn is required. If you have Node.js installed, you can install Yarn globally via npm: npm install --global yarn
Installation
- Clone the Repository: git clone https://github.com/EXXETA/trufos.git cd trufos
- Install Dependencies: Using Yarn, install all project dependencies: yarn install
Running in Development Mode
To start the application in development mode with hot reloading and access to developer tools:
yarn start
This command utilizes electron-forge start and will open the application window. Changes in the src/main or src/renderer directories will typically trigger a reload.
Building the Application
To build a distributable version of the application for your current platform:
- Ensure Dependencies are Installed: If you haven’t already, run: yarn install
- Run the Build Command: yarn run makeThis command uses electron-forge maketo package the application.
- Locate the Build Output: The built application will be located in the out/makedirectory. The specific file format depends on your operating system:- Windows: A Setup.exefile (Squirrel installer).
- macOS: A .dmgfile.
- Linux: A .zipfile (currently;.debis planned).
 
- Windows: A 
Testing
To run the test suite (using Vitest):
yarn test
This will execute tests for both the main and renderer processes.
Code Formatting and Linting
The project uses Prettier for code formatting and ESLint for linting.
- Check Formatting: yarn prettier-check
- Apply Formatting: yarn prettier
- Run Linter: yarn lint
Refer to the Coding Style guide for more details on setting up your IDE for automatic formatting.