Skip to content

Developers

HPO Curator is a tauri application with a Rust backend and an Angular front end.

The application makes major use of the following rust crates.

This page summarizes some of the angular and Rust/tauri commands that have been useful to create the application.

Initial setup

These steps were used to initialize the application and do not need to be repeated

1
npm create tauri@latest

The installer will ask questions about settings. We chose typescript, angular, npm.

Following this, run the following command.

1
npm install

Note that we are using standalone components.

Run the GUI application in development mode

1
npm run tauri dev

Creating new components

To generate a new component, navigate to the src/app folder, make a directory with the name of the component, cd into the new directory, and enter the following command.

1
npx nx generate @nx/angular:component <name> --standalone

This will initialize the typical four files for an angular component.

Set up file system access

At the top level of the project, enter

1
npm install @tauri-apps/api

in the src-tauri folder, enter

1
cargo add tauri-plugin-fs

for the shell component (which opens the system browser)

1
npm install @tauri-apps/api

In the angular component, add 

1
2
import { open } from '@tauri-apps/api/dialog';
import { readTextFile } from '@tauri-apps/api/fs';

Port issues

If one gets the error message: Port 1420 is already in use, then use the following command to obtain the process ID:

1
2
3
lsof -i :1420
COMMAND   PID  USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
node    32315 <user>   49u  IPv4 0xd9cc1bb0104a525f      0t0  TCP localhost:timbuktu-srv4 (LISTEN)

then end the process with

1
kill -9 <PID>

This may also cause the typescript part of the app to not be updated when we run npm run tauri dev.

Run in browser

Can be useful with the DevTools panel

1
npm run start

Problems with tauri.conf.json

Try to get the latest version

1
2
cargo install tauri-cli --locked
npm install @tauri-apps/cli@latest

generate a new file

1
cargo tauri init

file system (tauri v2)

npm run tauri add fs npm run tauri add dialog

.