Package Search
Full-text search across the entire package catalog — with live filter controls for type, trust level, price, and minimum rating. Results load with infinite scroll and update as filters change.
Search Fields
The search engine indexes three fields from each package manifest. All three are searched simultaneously — a query that matches any field returns that package as a result.
| Field | What Is Searched | Weight |
|---|---|---|
| Name | Package display name | Highest — exact name matches rank first |
| Description | Publisher's short and long description text | Medium — keyword matches in description |
| Tags | Publisher-defined tag array (max 10 tags) | High — tags are explicitly curated by the publisher |
Filter Controls
Filters appear in a left sidebar on the search page. All filters combine with AND logic — a result must satisfy all active filters to appear. Filters update results immediately without requiring a form submission.
| Filter | Options | Default |
|---|---|---|
| Package Type | Any / Workflow / Form / App / Node Library | Any |
| Trust Level | Any / Official / Certified / Community | Any |
| Minimum Rating | Any / 3+ stars / 4+ stars / 5 stars only | Any |
| Price | Any / Free only / Paid only | Any |
| Publisher Tier | Any / Gold+ / Platinum only | Any |
| Updated Within | Any / Last 30 days / Last 90 days / Last year | Any |
Sort Options
Users can override the default ranking algorithm with an explicit sort order. Sort preference is preserved in the URL so search links can be shared.
| Sort Option | Description |
|---|---|
| Relevance (default) | Weighted ranking formula (installs 30%, rating 25%, recency 20%, tier 15%, cert 10%) |
| Most Installed | Sorted by total install count descending |
| Highest Rated | Sorted by average rating descending (minimum 5 reviews required) |
| Newest | Sorted by publication date descending |
| Recently Updated | Sorted by last version release date descending |
Infinite Scroll
Search results use infinite scroll — the initial page loads 24 package cards. As the user scrolls to within 200px of the page bottom, the next 24 results load automatically. A result count is shown at the top of the results ("Showing 1–24 of 312 results").
Search results are served from a search index updated every 15 minutes. New packages, version updates, and rating changes may take up to 15 minutes to appear in search results after publication.
Search URL Parameters
The search page is fully URL-addressable — all filter and sort state is encoded in URL query parameters, making it easy to share searches or deep-link to a specific filtered view.
GET /discover?q=expense+approval&type=Workflow&trust=Certified&rating=4&sort=installs| Parameter | Values |
|---|---|
q | Search query string |
type | Workflow | Form | App | NodeLibrary |
trust | Official | Certified | Community |
rating | 3 | 4 | 5 |
price | free | paid |
tier | Gold | Platinum |
sort | relevance | installs | rating | newest | updated |