Browsing the catalog
The marketplace web app is a read-only view of the published index. Every card is a rendered feature contract.
Table of contents
The catalog
The landing page is a grid of every indexed feature, with a free-text search box and two filters.
| Filter | Values | Comes from |
|---|---|---|
| Archetype | full, light, service, config |
Source analysis when the contract is generated |
| Category | For example content, infrastructure, integration |
The category the author sets once in the contract, kept across regeneration |
The search matches name, repository, description and tags. feature:search runs the same kind of substring match offline, and also looks at the services and models a feature provides.
Full-text search with Elasticsearch
The catalog searches in memory. When the product also installs the elasticsearch feature, the marketplace switches to full-text search with fuzzy matching and relevance ranking, with no configuration. It is a soft dependency. The marketplace tries ElasticsearchService and falls back to memory when it is absent or unreachable. See dependency kinds.
The feature sheet
Clicking a feature opens its sheet, the whole contract plus what the indexer computed around it.
| Section | Shows |
|---|---|
| What it provides | Routes, blueprints, models, services, hooks, signals, commands, translations and Docker services |
| Hard requirements | requires.features, the features that must be in the product or this one breaks. feature:install enforces them |
| Works better with | requires.features_optional, the soft dependencies the feature works without (for example a public site that shows events only when the events feature is installed). Never enforced |
| Used by | The indexed features that require this one |
| Collisions | Features that provide the same route, service or model, and so cannot coexist in one product unless the SPL puts them in an alternative group |
| Distribution | The latest released tag, whether the package is on PyPI, and the source repository |
| Install command | The feature:install line to copy |
The CLI equivalent is feature:info.
Product lines
The Product lines page lists every SPL in the index with its parsed model, showing mandatory features, optional features and alternative groups (pick at most one, for example session_filesystem or session_redis). When the marketplace product also installs the configurator feature, each line has a Configure this line action that opens the configurator. Without it, the page renders without the button.