Installing Stork
There are two parts to Stork: the command line tool, and the Javascript module. Here, you'll learn how to install both.
The command line tool
Option 1: Install with Homebrew:
$ brew install stork-search/stork-tap/storkOption 2: Download a pre-compiled binary (Intel only):
$ wget https://files.stork-search.net/releases/v1.2.0/stork-macos-latest
$ chmod +x stork-macos-latestOption 3: If you have the Rust toolchain installed, use Cargo:
$ cargo install stork-searchOption 1: Download a pre-compiled binary:
$ wget https://files.stork-search.net/releases/v1.2.0/stork-ubuntu-latest
$ chmod +x stork-ubuntu-latestOption 2: If you have the Rust toolchain installed, use Cargo:
$ cargo install stork-searchInstall the Rust toolchain and install Stork with Cargo:
$ cargo install stork-searchIf these options don't work for you, please file a Github issue describing the installation process you hope to see!
The Javascript library
You can either load the Javascript library from the Stork CDN (backed by Cloudfront) or by self-hosting it.
From the Stork CDN:
Include the following script tag on your site, before your closing </body> tag:
<script src="https://files.stork-search.net/stork.js"></script>This will load the most recent Stork module along with the matching WASM binary. It will make a stork global variable available in the browser.
To load a specific version of the Stork Javascript library, you can reference a specific version:
<script src="https://files.stork-search.net/releases/v1.2.0/stork.js"></script>Self-hosting:
Download stork.js and stork.wasm from the latest Github release and publish those files on your web server. Be sure to serve stork.wasm with the correct MIME type, and be sure to call stork.initialize() with the URL where you're hosting the stork.wasm.
Visit the self-hosting guide for more information.
Updates
Stork updates contain bug fixes, indexing enhancements, UI enhancements, and additional configuration options.
The project aims to keep all Stork artifacts evergreen; in other words, an index configuration file you write will generate a valid index in all future versions of Stork, and an index itself will be useable on all future versions of the Stork Javascript library. However, some new features will only work with an updated Stork setup, and some new features will require that you rebuild your search index.
To track updates, follow the Stork Releases RSS feed.