{"id":13760684,"url":"https://github.com/healeycodes/crane-search","last_synced_at":"2026-02-15T20:03:39.149Z","repository":{"id":64046548,"uuid":"335145336","full_name":"healeycodes/crane-search","owner":"healeycodes","description":"🐦 A full-text WebAssembly search engine for static websites. Build, index, and fly.","archived":false,"fork":false,"pushed_at":"2023-01-20T13:49:15.000Z","size":7651,"stargazers_count":46,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-30T13:47:13.974Z","etag":null,"topics":["go-wasm","jamstack","search","static-site-search","wasm","webassembly"],"latest_commit_sha":null,"homepage":"https://healeycodes.github.io/crane-search/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/healeycodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-02T02:31:02.000Z","updated_at":"2025-04-11T20:13:06.000Z","dependencies_parsed_at":"2023-02-12T02:31:19.351Z","dependency_job_id":null,"html_url":"https://github.com/healeycodes/crane-search","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/healeycodes/crane-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/healeycodes%2Fcrane-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/healeycodes%2Fcrane-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/healeycodes%2Fcrane-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/healeycodes%2Fcrane-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/healeycodes","download_url":"https://codeload.github.com/healeycodes/crane-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/healeycodes%2Fcrane-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29487789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go-wasm","jamstack","search","static-site-search","wasm","webassembly"],"created_at":"2024-08-03T13:01:16.619Z","updated_at":"2026-02-15T20:03:39.121Z","avatar_url":"https://github.com/healeycodes.png","language":"Go","readme":"# Crane 🐦\n\n\u003e My blog post: [WebAssembly Search Tools for Static Sites](https://healeycodes.com/webassembly-search-tools-for-static-websites/)\n\n\u003cbr\u003e\n\nCrane is a technical demo is inspired by [Stork](https://github.com/jameslittle230/stork) and uses a near-identical configuration file setup. So it had to be named after a bird too.\n\nI wrote it to help me understand how WebAssembly search tools work. Please use Stork instead.\n\nCrane is two programs. The first program scans a group of documents and builds an efficient index. 1MB of text and metadata is turned into a 25KB index (14KB gzipped). The second program is a Wasm module that is sent to the browser along with a little bit of JavaScript glue code and the index. The result is an instant search engine that helps users find web pages as they type.\n\n[Visit the demo](https://healeycodes.github.io/crane-search/)\n\n\u003cbr\u003e\n\n[![Crane instant search in action](https://github.com/healeycodes/crane-search/blob/main/docs/crane.gif)](https://healeycodes.github.io/crane-search/)\n\n\u003cbr\u003e\n\nThe full text search engine is powered in part with code from Artem Krylysov's blog post [Let's build a Full-Text Search engine](https://artem.krylysov.com/blog/2020/07/28/lets-build-a-full-text-search-engine/).\n\nNo effort has been made to shrink the Wasm binary. See [Reducing the size of Wasm files](https://github.com/golang/go/wiki/WebAssembly#reducing-the-size-of-wasm-files).\n\n## Use it\n\nDescribe your document files and their metadata.\n\n```toml\n[input]\nfiles = [\n    {\n        path = \"docs/essays/essay01.txt\",\n        url = \"essays/essay01.txt\",\n        title = \"Introduction\"\n    },\n    # etc.\n]\n\n[output]\nfilename = \"dist/federalist.crane\"\n```\n\nPass the configuration file to the build script. You'll want a fresh index whenever your documents change but you only need to build the Wasm module once ever.\n\n```bash\n./build-index.sh federalist.toml\n./build-search.sh\n```\n\nHost the files from `/dist` on your website (e.g. `wasm_exec.js`, `crane.js`, `crane.wasm`, `federalist.crane`). And away you go!\n\n```javascript\nconst crane = new Crane(\"crane.wasm\", \"federalist.crane\");\nawait crane.load();\n\nconst results = crane.query('some keywords');\nconsole.log(results);\n```\n\nSee the demo inside `/docs` for a basic UI.\n\n\u003cbr\u003e\n\n## Build demo page\n\n```bash\n./gh-pages.sh\n```\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhealeycodes%2Fcrane-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhealeycodes%2Fcrane-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhealeycodes%2Fcrane-search/lists"}