From: Ruben Beltran del Rio Date: Thu, 14 Sep 2023 09:14:53 +0000 (+0200) Subject: Update docs X-Git-Url: https://git.r.bdr.sh/rbdr/junction/commitdiff_plain/5d2c4ecb44233569a516dde301a02d44098ec15d?ds=sidebyside Update docs --- diff --git a/Makefile b/Makefile index ab4d615..dfcadb0 100644 --- a/Makefile +++ b/Makefile @@ -25,5 +25,5 @@ create-build-folder: mkdir -p build format: - prettier . --write + pnpx prettier . --write xcodebuild -project safari/Junction.xcodeproj | xcbeautify diff --git a/README.md b/README.md index 345fa6b..ccd9b12 100644 --- a/README.md +++ b/README.md @@ -26,13 +26,21 @@ The project is divided into three main parts: ### Dependencies -- `make` to run the build commands. -- `xcode` to build the safari extension. +- `make` to run the build commands. It's included in `macos` +- `xcode` to build the safari extension. Can be downloaded from the + [apple developer portal][xcode-download]. - `node` and `pnpm` to build the extension, and if you want to run the server - directly. + directly. Node can be installed via brew with `brew install node`, or with + a version manager like [asdf][asdf]. For `pnpm` check the [website][pnpm]. - `podman` and `podman-compose` if you want to run the server as a container. -- `prettier` to format Javascript, JSON, Yaml, and Markdown. -- `xcbeautify` to format swift + Both can be installed with homebrew `brew install podman podman-compose` +- `prettier` to format Javascript, JSON, Yaml, and Markdown. Will automatically + install when running `make format`. +- `xcbeautify` to format swift. Can be installed with homebrew + `brew install xcbeautify` + +If you're running macos and using homebrew, you can install them all with +`make prepare-environment`. ### Server @@ -83,3 +91,7 @@ Open `Junction.app` and then enable the extension in Safari. ### Formatting Running `make format` will format the code with prettify and xcbeautify + +[xcode-download]: https://developer.apple.com/xcode/resources/ +[asdf]: https://asdf-vm.com/ +[pnpm]: https://pnpm.io/installation