Template Discovery
Find the right blueprint template faster with curated discovery surfaces — trending templates, personalized recommendations, full-text search with filters, and community ratings.
Overview
Template Discovery enhances the Blueprints page with three sections:
- Trending — templates gaining popularity, ranked by a 7-day weighted score
- Recommended — personalized suggestions based on your adoption history
- Search — full-text search with protocol, category, and source filters
This feature requires the growth_template_discovery feature flag to be enabled.
Trending Templates
The Trending section displays a responsive grid of popular templates. Each card shows:
- Template name and description (2-line clamp)
- Category and protocol badges
- Source indicator (Official or Community)
- Adoption count and trending indicator
- Average star rating
If no templates are trending, the section is hidden automatically.
Personalized Recommendations
The Recommended for You row appears as a horizontally scrollable list of templates matching categories you've adopted before.
- New users with no adoption history receive a curated fallback set
- The row hides when no recommendations are available
Search and Filter
Use the controls at the top of the page:
| Control | Description |
|---|---|
| Search bar | Full-text search across template name, description, and tags |
| Protocol chips | Filter by protocol (REST, LDAP, JDBC, gRPC, etc.) |
| Sort dropdown | Order by Relevance, Trending, Recently Added, or Highest Rated |
Filters are URL-based (?q=...&protocol=...&sortBy=...) — you can bookmark or share a filtered view.
Search results include:
- Matching templates in a paginated grid
- Facets — category and source distribution counts
- Pagination controls
Template Preview
Click any template card to open the Template Preview Modal:
- Stats grid — endpoint count, adoption count, average rating
- Endpoint list — scrollable list of routes with HTTP method badges
- Reviews tab — paginated community reviews
- Rate This tab — submit your own rating
Actions
| Button | Description |
|---|---|
| Adopt Template | Link the template to your library (receives upstream updates) |
| Fork Template | Create an independent copy you can customize |
Rating Templates
- Open any template via the preview modal
- Switch to the Rate This tab
- Click a star (1–5) — hover previews the selection
- Optionally add a review comment (up to 2,000 characters)
- Click Submit Rating
Re-rating the same template updates your existing rating.
How Trending Scores Work
The trending score is a composite metric:
- Recent adoptions (last 7 days) weighted more than older ones
- Rating quality (average) and volume (total count) factor in
- Templates with high adoption velocity overtake stale popular ones
Recently Added
A compact vertical list showing the newest templates with:
- Template name
- Protocol badge
- Relative date ("Today", "Yesterday", "3 days ago")
Limitations
- Recommendations require at least one prior adoption to personalize
- Full-text search uses PostgreSQL
tsvector— stemming applies
Next Steps
- Demo Packs — Deploy curated template bundles
- Community Templates — Contribute your own templates
- Managing Simulations — Use adopted templates in simulations