Identity Wallet for people to manage Decentralized Identities and Verifiable Credentials.

This app is built with Tauri 2.0. It uses Rust in the backend and SvelteKit, Tailwind CSS, and Melt UI in the frontend.

Checkout the Prerequisites for running Tauri apps on your system to get started.

This repository uses pnpm workspaces:

Get up and running with these steps:

Copy the file .env.example to .env and set the values accordingly.

pnpm i

cd unime/src-tauri
cargo tauri icon

You can run the following commands from the project root:

# Desktop
pnpm tauri dev

# Android
pnpm tauri android init
pnpm tauri android dev

# iOS
pnpm tauri ios init
pnpm tauri ios dev

export ANDROID_NDK_ROOT=$NDK_HOME
export ANDROID_NDK=$NDK_HOME
export CC="$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/bin/armv7a-linux-androideabi21-clang"
export BINDGEN_EXTRA_CLANG_ARGS="--sysroot=$ANDROID_NDK_ROOT/toolchains/llvm/prebuilt/linux-x86_64/sysroot"

Run the following commands from the project root:

pnpm format
pnpm lint
pnpm test

Run these commands from ./unime/src-tauri:

cargo fmt
cargo clippy
cargo test

Run these commands from ./identity-wallet:

cargo fmt
cargo clippy
cargo test

In order to regenerate the TypeScript bindings in identity-wallet/bindings after making changes to actions or reducers, you can simply execute all Rust tests by running cargo test from within the /identity-wallet folder.

1. Edit the base language file (English) at unime/src/i18n/en/index.ts.
2. Inside the unime folder, run pnpm typesafe-i18n to update the types.
3. Adjust all other language files in unime/src/i18n/ accordingly until all types are satisfied.
4. Running pnpm check shouldn't produce any errors related to i18n.

Recommended extensions are listed in .vscode/extensions.json.

If you have issues with cargo tauri build run the following command.

# Linux, macOS
rm -rf ~/.cargo/git/checkouts/*

# Windows
rd /s /q "%USERPROFILE%\.cargo\git\checkouts"

You can simulate safe area insets during development by overriding CSS variables --safe-area-inset-top and --safe-area-inset-button in unime/src/app.css. You can add styling to the safe area insets by setting PUBLIC_STYLE_SAFE_AREA_INSETS=true in your .env.

1. Search the entire project for the current version string (such as 0.6.2) and replace them with the new version string. Be cautious not to replace versions of any other dependencies (in Cargo.toml, Cargo.lock, package.json, package-lock.json).
2. Run the script in unime/src-tauri/gen-static/apply.sh which copies over the changed files into the (untracked) generated folders for Android and iOS.
3. Inside unime/src-tauri run cargo tauri icon.
4. To create a release build, there is a special tweak for the respective platform:
   • For iOS, open Xcode and open the root file unime.xcodeproj. Go to Signing & Capabilities, disable Automatically manage signing and select the Provisioning Profile manually.
   • For Android, create a keystore.properties file in unime/src-tauri/gen/android which contains the secrets required in build.gradle.kts (such as keyAlias, etc.).
5. Run pnpm tauri ios build and pnpm tauri android build to build the apps. The iOS build (.ipa) will be in unime/src-tauri/gen/apple/build/arm64 and the Android builds (.apk and .aab) will be in unime/src-tauri/gen/android/app/build/outputs/.