Frontend Setup

Prerequisites

Before setting up the frontend, ensure you have the following installed:

Node.js (LTS version recommended)
npm (comes with Node.js)
Rust (latest stable version)
Tauri CLI

For a comprehensive guide on prerequisites, refer to the Tauri Prerequisites documentation.

Setup Directory

Base Directory

All commands executed below are with respect to the frontend/ directory

Installing Dependencies

Navigate to the frontend directory:

cd frontend

Install the project dependencies:
For Windows/Mac
```
npm install
```
For Linux

1.Installing Dependencies
```
 npm install
```
2.Grant executable permissions to the setup script:
```
chmod +x scripts/setup_env.sh
```
3.Run the dependencies script ```bash npm run setup:linux

For more information on npm commands, see the npm documentation.

Running the Application

To start the Tauri application in development mode, run:

npm run tauri dev

This command will:

Start the Vite development server for the frontend
Compile the Rust backend
Launch the Tauri application window

For more details on Tauri commands, check the Tauri CLI documentation.

First Run

The first run might take longer as it needs to compile the Rust code.

Building for Production

To create a production build of your Tauri application:

Create Signing Keys for tauri using the command:

npm run tauri signer generate

Set the public key in tauri.conf.json as pubkey and private key and password in Enviroment Variables as TAURI_SIGNING_PRIVATE_KEY and TAURI_SIGNING_PRIVATE_KEY_PASSWORD

There is a preset pubkey in tauri.conf.json ; private key and password for it is:

TAURI_SIGNING_PRIVATE_KEY=dW50cnVzdGVkIGNvbW1lbnQ6IHJzaWduIGVuY3J5cHRlZCBzZWNyZXQga2V5ClJXUlRZMEl5NlF2SjE3cWNXOVlQQ0JBTlNITEpOUVoyQ3ZuNTdOSkwyNE1NN2RmVWQ1a0FBQkFBQUFBQUFBQUFBQUlBQUFBQU9XOGpTSFNRd0Q4SjNSbm5Oc1E0OThIUGx6SS9lWXI3ZjJxN3BESEh1QTRiQXlkR2E5aG1oK1g0Tk5kcmFzc0IvZFZScEpubnptRkxlbDlUR2R1d1Y5OGRSYUVmUGoxNTFBcHpQZ1dSS2lHWklZVHNkV1Byd1VQSnZCdTZFWlVGOUFNVENBRlgweUU9Cg==

TAURI_SIGNING_PRIVATE_KEY_PASSWORD=pass

npm run tauri build

This will create an optimized build of your application in the src-tauri/target/release directory.

Learn more about building Tauri apps in the Tauri Building Guide.

Running the Dockerfile

To build the Docker image, use the following command:

docker build --build-arg TAURI_SIGNING_PRIVATE_KEY=<private_key> --build-arg TAURI_SIGNING_PRIVATE_KEY_PASSWORD=<password> -t <image_name> .

Replace and with your actual Tauri signing private key and password and with the image name. If you are using the default key, you can use the following command:

docker build --build-arg TAURI_SIGNING_PRIVATE_KEY=dW50cnVzdGVkIGNvbW1lbnQ6IHJzaWduIGVuY3J5cHRlZCBzZWNyZXQga2V5ClJXUlRZMEl5NlF2SjE3cWNXOVlQQ0JBTlNITEpOUVoyQ3ZuNTdOSkwyNE1NN2RmVWQ1a0FBQkFBQUFBQUFBQUFBQUlBQUFBQU9XOGpTSFNRd0Q4SjNSbm5Oc1E0OThIUGx6SS9lWXI3ZjJxN3BESEh1QTRiQXlkR2E5aG1oK1g0Tk5kcmFzc0IvZFZScEpubnptRkxlbDlUR2R1d1Y5OGRSYUVmUGoxNTFBcHpQZ1dSS2lHWklZVHNkV1Byd1VQSnZCdTZFWlVGOUFNVENBRlgweUU9Cg== --build-arg TAURI_SIGNING_PRIVATE_KEY_PASSWORD=pass -t <image_name> .

This command uses the preset private key and password.

Troubleshooting

If you encounter any issues during setup or running the application:

Ensure all prerequisites are correctly installed.
Check that you're in the correct directory (frontend/).
Try deleting the node_modules folder and package-lock.json file, then run npm install again.
If Rust-related errors occur, try running rustup update to ensure you have the latest version.

For more detailed troubleshooting, refer to the Tauri Troubleshooting Guide.

Additional Resources

By following these steps, you should have your Tauri frontend environment set up and ready for development. Remember to run npm run tauri dev to start your development environment.