vault-link/README.md
2025-10-19 14:43:11 +01:00

2.1 KiB

VaultLink self-hosted Obsidian plugin for file syncing

Check E2E tests Publish server Docker image Publish Obsidian plugin

Develop

Install nvm

  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
  • nvm install 22
  • nvm use 22
  • Optionally set the system-wide default: nvm alias default 22

Set up Rust

  • Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Install wasm-pack: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
  • cargo install cargo-insta sqlx-cli cargo-edit

Install Obsidian on Linux

apt install flatpak
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install flathub md.obsidian.Obsidian
flatpak run md.obsidian.Obsidian

Run in development mode

Start the server:

cargo install sqlx-cli cargo-machete cargo-edit
cd sync-server
cargo run config-e2e.yml
cd frontend
npm install
npm run dev

Scripts

Before pushing

scripts/check.sh --fix

Update HTTP API TS bindings

scripts/update-api-types.sh

Publish new version

scripts/bump-version.sh patch

Run E2E tests

scripts/e2e.sh

And to clean up the logs & database files, run scripts/clean-up.sh

Projects