List Starters
GET /api/starters
Returns a paginated list of starter templates. The results can be filtered by technologies, features, and quality scores.
Query Parameters
Pagination
page
Page number (1-based). Defaults to 1.
Example: ?page=2
per_page
Number of items per page. Defaults to 20, maximum 100.
Example: ?per_page=50
Filtering
technologies
Filter by technologies. Can be specified multiple times or as comma-separated values. Returns starters that use ANY of the specified technologies.
Examples:
?technologies=react,typescript
?technologies=react&technologies=typescript
features
Filter by features. Can be specified multiple times or as comma-separated values. Returns starters that have ANY of the specified features.
Examples:
?features=authentication,testing
?features=development.testing&features=security.authentication
min_quality
Filter by minimum quality score (1-5). Returns starters with a quality score greater than or equal to the specified value.
Example: ?min_quality=4
min_matched
Filter by minimum number of matched filters. Only applies when technologies or features are specified. Returns starters that match at least this many of the specified filters.
Example: ?technologies=react,typescript&min_matched=2
Response
Success Response
{
"items": [
{
"metadata": {
"name": "starter-name",
"url": "https://github.com/user/repo"
},
"technologies": ["react", "typescript"],
"features": {
"development": {
"testing": true
}
},
"quality": {
"maintenance": {
"commitFrequency": 4,
"issueResponseTime": 5
},
"documentation": {
"readmeCompleteness": 4,
"setupInstructions": 5,
"exampleCoverage": 4
}
},
"match_score": {
"matched": 2,
"total": 3
}
}
],
"pagination": {
"total_items": 100,
"total_pages": 5,
"current_page": 1,
"per_page": 20,
"has_next": true,
"has_previous": false
}
}
Error Response
{
"error": {
"status": 400,
"message": "Invalid parameter value"
}
}
Example Requests
Basic Pagination
GET /api/starters?page=2&per_page=50
Technology Filter
GET /api/starters?technologies=react,typescript&min_quality=4
Feature Filter
GET /api/starters?features=development.testing,security.authentication&min_matched=2