Contribute to Vault Explorer

Issues

Please open an issue for bugs or suggestions for improvement. All feedback is welcome.

Pull requests

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Project installation

Fork the Vault Explorer repository from GitHub

Install Bun.sh for your operating system

Clone the forked repository

git clone https://github.com/<your-username>/obsidian-vault-explorer.git

Change directories to the repository on your machine

cd obsidian-vault-explorer

Install dependencies

bun install

Build the project. This will create a dist folder

bun run build

The repository that you cloned contains a folder called test-vault. This is what will be used for development.

The test-vault contains a .obsidian/plugins/vault-explorer folder with a data.json file but it is missing the main.js, manifest.json and styles.css.

We need to create symbolic links for each of these folders

cd test-vault/.obsidian/plugins/vault-explorer

ln -s ../../../../dist/main.js .

ln -s ../../../../dist/manifest.json .

ln -s ../../../../dist/styles.css .

Development

Checkout the dev branch and make a child branch off of it.

git pull dev

git checkout dev

git checkout -b <your-branch-name>

Important

Please make sure that you make a branch off of dev instead of master. This will help reduce merge conflicts by making sure that you have the latest code changes.

Run esbuild in development mode

bun run dev

Make some code changes

Restart your Obsidian application to see your code changes in action

Open a pull request

Once you have commited your changes, push your code to GitHub and open a pull request.

Please choose your branch and dev as the branch you want to merge into.

Your pull request will be reviewed. Once it is approved, it will be merged.

2.1 KiB Raw Blame History