set shell := ['bash', '-c']

set windows-shell := ['powershell', '-Command']

set dotenv-load := true

bash := if os() == 'windows' { 'env -S bash -euo pipefail' } else { '/usr/bin/env -S bash -euo pipefail' }

powershell := if os() == 'windows' {'powershell.exe'} else {'/usr/bin/env pwsh'}

bun := if os() == 'windows' { 'bun.exe' } else { '/usr/bin/env bun' }

RUST_TOOLCHAIN := env('RUST_TOOLCHAIN', 'stable')

RUSTFLAGS := env('RUSTFLAGS','')

CI := env('CI', 'false')

GITHUB_ENV := env('GITHUB_ENV', '.GITHUB_ENV')

KEY_FILE := join(home_directory(), ".tauri", "memospot_updater.key")

KEY_FILE_CONTENTS := if path_exists(KEY_FILE)=="true" { trim_end(read(KEY_FILE))} else {""}

TAURI_SIGNING_PRIVATE_KEY := env('TAURI_SIGNING_PRIVATE_KEY', KEY_FILE_CONTENTS)

TAURI_SIGNING_PRIVATE_KEY_PASSWORD := env('TAURI_SIGNING_PRIVATE_KEY_PASSWORD', '')

GIT_WIN := join(env('PROGRAMFILES',''), 'Git','usr','bin')

PATH := if os() == 'windows' { GIT_WIN +';'+ env('PATH') } else { env('PATH') }

REPO_ROOT := justfile_directory()

BIOME_CONFIG_PATH := join(REPO_ROOT,'biome.jsonc')

DPRINT_CACHE_DIR := join(REPO_ROOT,'.dprint')

RUST_BACKTRACE := 'full'

RUST_TARGETS := if os() == 'windows' {

'x86_64-pc-windows-msvc'

} else if os() == "macos" {

'aarch64-apple-darwin x86_64-apple-darwin'

} else {

'x86_64-unknown-linux-gnu'

}

RUSTC_WRAPPER := env('RUSTC_WRAPPER', '')

CARGO_INCREMENTAL := if RUSTC_WRAPPER == '' { '1' } else { '0' }

TS_RS_EXPORT_DIR:= join(REPO_ROOT,'src-ui','src','lib','types','gen')

set export

[private]

#!{{bash}}

echo "REPO_ROOT is ${REPO_ROOT}"

echo -e "{{BOLD}}This justfile contains recipes for building {{UNDERLINE}}https://github.com/memospot/memospot{{NORMAL}}.\n"

if [[ "{{os()}}" == "windows" ]]; then

git_win="{{replace(GIT_WIN, '\\', '\\\\')}}"

echo -e "To use this justfile on Windows, make sure Git is installed under {{BOLD}}{{UNDERLINE}}$git_win{{NORMAL}}."

echo -e "{{BOLD}}{{UNDERLINE}}https://git-scm.com/download/win{{NORMAL}}"

echo ""

fi

deps=(

"bash"

"bun"

"cargo"

"dprint"

"git"

"rustc"

)

for dep in "${deps[@]}"; do

if ! command -v "$dep" &> /dev/null; then

echo -e "{{RED}}ERROR:{{NORMAL}} Please install {{MAGENTA}}{{BOLD}}{{UNDERLINE}}$dep{{NORMAL}}."

echo -e "Try running {{BOLD}}{{UNDERLINE}}just setup{{NORMAL}}."

exit 1

fi

done

echo -e "{{GREEN}}Found project dependencies: ${deps[@]}{{NORMAL}}"

echo -e "{{YELLOW}}This quick test does not verify tool versions. If you experience any errors, consider updating the related tool.{{NORMAL}}\n"

just --list

[private]

pushd "src-ui"; bun install; popd

pushd "build-scripts"; bun install; popd

[private]

dev-ui: deps-ts

#!{{bash}}

cd "src-ui" && bunx --bun svelte-kit sync && bunx vite dev

[private]

download-memos: deps-ts

#!{{bash}}

for i in 1 2 3; do

bun run ./build-scripts/bin/downloadMemos.ts && break || sleep 10

done

[private]

tauri-before-build: download-memos gen-icons gen-bindings build-ui

[private]

tauri-before-bundle: deps-ts

[private]

tauri-before-dev: download-memos gen-icons gen-bindings dev-ui

[group('test')]

[doc('Run all tests')]

test: test-ts test-crates test-rs test-tauri

[group('test')]

[doc('Run all crate tests')]

cargo test --workspace --exclude memospot --lib -- --nocapture

[group('test')]

[doc('Run all Rust tests')]

#!{{bash}}

export CARGO_PROFILE_TEST_BUILD_OVERRIDE_DEBUG=true

cargo test --workspace --lib -- --nocapture

[group('test')]

[doc('Run all Tauri tests')]

cargo test --package memospot --lib -- --nocapture

[group('test')]

[doc('Run all TypeScript tests')]

test-ts: deps-ts

#!{{bun}}

import fs from "node:fs";

const dirs = ["./build-scripts", "./src-ui"];

let results = [];

for (const dir of dirs) {

const files = fs.readdirSync(dir, {recursive: true}).filter(fn => fn.endsWith('.test.ts'));

if (files.length === 0) {

continue;

}

console.log(`> Running tests in ${dir}`);

await Bun.spawn({

cmd: ["bun", "test"],

cwd: dir,

onExit(proc, exitCode, signalCode, error) {

results.push(exitCode === 0);

}

}).exited;

}

const allPassed = results.every((result) => result);

allPassed ? console.log("All tests passed.") : console.error("Some tests failed.");

process.exit(allPassed ? 0 : 1);

[doc('Run app in development mode')]

dev: dev-killprocesses

cargo tauri dev

just dev-killprocesses

[private]

[linux]

[macos]

#!{{bash}}

for process in "memospot" "memos"; do

killall $process > /dev/null 2>&1 || true

done

[private]

[windows]

#!{{powershell}}

[System.Diagnostics.Process]::GetProcesses() | Where-Object {

$_.ProcessName -in "memospot", "memos"

} | Stop-Process -Force -ErrorAction SilentlyContinue

[group('update')]

[doc('Update project dependencies')]

[confirm('This will update all dependencies. This should be done carefully. Are you sure?')]

update: update-dprint update-rs update-ts

[group('update')]

[doc('Update dprint plugins')]

dprint config update

[group('update')]

[doc('Update cargo crates')]

cargo update

[group('update')]

[doc('Update npm packages')]

#!{{bash}}

pushd "./src-ui"; bun update; popd

pushd "./build-scripts"; bun update; popd

just fmt

[group('update')]

[doc('Show outdated npm packages')]

#!{{bash}}

pushd "./src-ui"; bun outdated; popd

pushd "./build-scripts"; bun outdated; popd

just fmt

[group('upgrade')]

[doc('Upgrade project toolchain')]

upgrade: upgrade-rust upgrade-bun

[group('upgrade')]

[doc('Upgrade Rust toolchain')]

rustup update

rustup self update

rustup component add clippy rust-analyzer

[group('upgrade')]

[doc('Upgrade bun runtime')]

bun upgrade

#!{{bash}}

cargo tauri icon "assets/app-icon-lossless.webp"

cp -f "./crates/memospot/icons/icon.ico" "./src-ui/static/favicon.ico"

git add "assets/app-icon-lossless.webp" "crates/memospot/icons/*"

# git commit -m "chore: regenerate icons"

[doc('Generate app icons, if needed')]

#!{{bash}}

if [ "$CI" = "true" ]; then exit 0; fi

check_files=(

"assets/app-icon-lossless.webp"

"crates/memospot/icons/**.png"

"crates/memospot/icons/icon.ico"

"src-ui/static/favicon.ico"

)

for file in "${check_files[@]}"; do

if ! git diff --quiet --exit-code HEAD -- "$file"; then

echo "{{YELLOW}}$file was modified since last commit, regenerating icons…{{NORMAL}}"

just gen-icons-force

exit 0

fi

done

echo -e "{{GREEN}}App icons are up to date.{{NORMAL}}"

#!{{bash}}

mkdir -p "$TS_RS_EXPORT_DIR"

# Files listed here may affect the frontend bindings.

check_files=(

"crates/config/**/*"

"crates/memospot/src/runtime_config.rs"

)

for file in "${check_files[@]}"; do

if ! git diff --quiet --exit-code HEAD -- "$file"; then

echo -e "{{YELLOW}}${file} was modified since last commit, regenerating TypeScript bindings…{{NORMAL}}"

pushd crates/memospot; cargo test export_bindings; popd

exit 0

fi

done

echo -e "{{CYAN}}Skipping TypeScript bindings regeneration, no changes detected.{{NORMAL}}"

cd "src-ui"; bun run build

[doc('Build UI, if needed')]

#!{{bash}}

if ! git diff --quiet --exit-code HEAD -- "src-ui/src/**" || [ ! -d "./src-ui/build/" ] || [ ! -f "./src-ui/build/index.html" ]; then

just build-ui-force

else

echo -e "{{GREEN}}UI is up to date.{{NORMAL}}"

fi

[doc('Build app')]

build TARGET='all':

#!{{bash}}

if [ "{{TARGET}}" = "no-bundle" ]; then

cargo tauri build --no-bundle

just postbuild

exit 0

fi

if [ -z $TAURI_SIGNING_PRIVATE_KEY ] && [ -f $HOME/.tauri/memospot_updater.key ]; then

export TAURI_SIGNING_PRIVATE_KEY=$(cat $HOME/.tauri/memospot_updater.key 2>/dev/null | tr -d '\n' || echo "")

echo -e "{{CYAN}}Setting TAURI_SIGNING_PRIVATE_KEY from $HOME/.tauri/memospot_updater.key{{NORMAL}}"

fi

if [ -z $TAURI_SIGNING_PRIVATE_KEY ] || [ -z $TAURI_SIGNING_PRIVATE_KEY_PASSWORD ]; then

echo -e "{{YELLOW}}Environment not fully configured. Building without updater.{{NORMAL}}"

cargo tauri build -c '{"bundle": {"targets": "{{TARGET}}" }, "plugins": {"updater": {}}}'

else

cargo tauri build -c '{"bundle": {"targets": "{{TARGET}}" }}'

fi

just postbuild

[doc('Actions: prune, lint, test, linux, windows, linux-no-bundle, windows-no-bundle.')]

[group('Docker Bake')]

bake ACTION='':

#!{{bash}}

if [ "{{ACTION}}" = "prune" ]; then

docker builder du

docker builder prune -a

else

docker buildx bake {{ACTION}}

test -d "./build" && sudo chown -R $(id -u):$(id -g) ./build

fi

[linux]

#!{{bash}}

flatpak install -y flathub org.flatpak.Builder

shopt -s expand_aliases

alias flatpak-builder-lint="flatpak run --command=flatpak-builder-lint org.flatpak.Builder"

flatpak-builder-lint appstream ./installer/flatpak/io.github.memospot.Memospot.metainfo.xml

flatpak-builder-lint manifest ./installer/flatpak/io.github.memospot.Memospot.yml

flatpak-builder-lint repo ./target/flatpak-repo

[linux]

#!{{bash}}

just build deb

flatpak-builder --force-clean --user --install-deps-from=flathub --repo=./target/flatpak-repo --install ./target/flatpak ./installer/flatpak/io.github.memospot.Memospot.yml

[linux]

flatpak run io.github.memospot.Memospot

[linux]

#!{{bash}}

pid="$(pidof memospot)"

test -z $pid && echo -e "{{RED}}Memospot is not running.{{NORMAL}}" && exit 1

tr '\0' '\n' < /proc/$pid/environ | sort

[private]

#!{{bash}}

set +e

echo -e "{{CYAN}}Moving relevant build files to ./build directory…{{NORMAL}}"

! test -d "./build" && mkdir -p "./build"

artifacts=(

"bundle/appimage/*.AppImage"

"bundle/deb/*.deb"

"bundle/msi/*.msi"

"bundle/nsis/*.exe"

"bundle/rpm/*.rpm"

"dist/"

"memos"

"memos.exe"

"memospot"

"memospot.exe"

)

for artifact in "${artifacts[@]}"; do

resolved_path="$(find ./target/release/$artifact -type f 2>&1 | head -n 1)"

test -f "$resolved_path" && mv -f "$resolved_path" ./build/. 2>/dev/null

done

pushd "./build"

appimages=($(find *.AppImage -type f 2>&1))

for appimage in "${appimages[@]}"; do

! test -f "${appimage}" && continue

! test -d "${appimage}.home" && mkdir -p "${appimage}.home"

done

if ls ./memos* 1> /dev/null 2>&1; then

echo -e "{{GREEN}}Done.{{NORMAL}}"

else

echo -e "{{RED}}Failed to move files.{{NORMAL}}"

fi

popd

[doc('Clean project artifacts')]

clean:

#!{{bash}}

set +e

for d in "./src-ui" "./build-scripts"; do

pushd "$d" && bun pm cache rm && popd

done

cargo cache -a || true

dirs=(

"./.dprint"

"./build"

"./build-scripts/node_modules"

"./node_modules"

"./server-dist"

"./src-ui/.vite"

"./src-ui/build"

"./src-ui/node_modules"

"./target"

)

for item in "${dirs[@]}"; do

test -d "$item" && rm -rf "$item"

done

exit 0

[group('lint')]

[doc('Run all code linters')]

lint: lint-dprint lint-ts lint-rs

[group('lint')]

[doc('Check code formatting')]

dprint check

[group('lint')]

[doc('Lint Rust code with cargo fmt and clippy')]

cargo fmt --all --check

cargo clippy --all-features --all-targets --workspace --locked

[group('lint')]

[doc('Lint TypeScript code with BiomeJS')]

bun x @biomejs/biome ci --css-parse-tailwind-directives=true .

[group('fix')]

[doc('Run all code fixes')]

fix: fix-ts fix-rs

[group('fix')]

[doc('Run cargo fix (requires clean repo)')]

cargo fix || just fix-rs-dirty

[group('fix')]

[confirm('This will run `cargo fix --allow-dirty`. This can perform destructive changes. Are you sure?')]

cargo fix --allow-dirty

[group('fix')]

[doc('Run BiomeJS safe fixes')]

#!{{bash}}

for d in "./build-scripts" "./src-ui"; do

cd "$REPO_ROOT/$d"

if ls *.ts 1> /dev/null 2>&1; then

bun x @biomejs/biome lint --apply .

fi

done

[group('format')]

[doc('Format code with dprint (json, rust, toml, yaml, html, css, typescript and markdown).')]

dprint fmt --diff

[doc('Run all recommended pre-commit checks')]

pre-commit: fmt lint test

[group('maintainer')]

[doc('Delete all GitHub build cache')]

gh cache delete --all

[group('maintainer')]

#!{{bash}}

if ! git diff-index --quiet HEAD --; then

echo -e "{{MAGENTA}}There are unstaged changes.{{NORMAL}}"

elif ! git diff-files --quiet; then

echo -e "{{MAGENTA}}There are unstaged changes.{{NORMAL}}"

elif ! git status; then

echo -e "{{MAGENTA}}There are untracked files.{{NORMAL}}"

elif ! [ -z "$(git ls-files --deleted)" ]; then

echo -e "{{MAGENTA}}There are deleted files.{{NORMAL}}"

elif ! [ -z "$(git ls-files --modified)" ]; then

echo -e "{{MAGENTA}}There are modified files.{{NORMAL}}"

else

echo -e "{{GREEN}}Repository is clean.{{NORMAL}}"

exit 0

fi

exit 1

[group('maintainer')]

[doc('Bump version in Cargo.toml and crates/memospot/Cargo.toml')]

bumpversion VERSION:

#!{{bash}}

clean="{{trim_start_match(VERSION, "v")}}"

cargo set-version --locked "$clean"

cargo generate-lockfile

for d in "." "./build-scripts" "./src-ui"; do

jq --arg version "$clean" '.version = $version' "$d/package.json" > "$d/package.json.tmp" && mv "$d/package.json.tmp" "$d/package.json"

done

just fmt

bun install --lockfile-only

git add ./crates/memospot/Cargo.toml ./crates/memospot/Tauri.toml ./Cargo.lock ./Cargo.toml \

./build-scripts/package.json ./src-ui/package.json ./package.json ./bun.lock

git commit -m "chore: bump version to v$clean"

[group('maintainer')]

[doc('Push a new tag to the repository')]

pushtag TAG:

#!{{bash}}

clean="{{trim_start_match(TAG, "v")}}"

git tag -a "v$clean" -m "chore: push v$clean"

git push origin --tags

[group('maintainer')]

[doc('Publish a new version (bumpversion + pushtag)')]

publish TAG:

just bumpversion {{TAG}}

just pushtag {{TAG}}