Skip to main content

Stars & Reviews

Stars and reviews are the primary community feedback mechanisms. Stars are lightweight bookmarks that also feed the trending algorithm. Reviews provide detailed ratings and written feedback.

Stars​

Starring an Appgrammar​

Toggle a star with POST /api/appgrammars/:id/star. The endpoint is idempotent -- calling it again removes the star. No request body is needed.

Check if you've starred an appgrammar: GET /api/appgrammars/:id/starred.

List all your starred appgrammars: GET /api/users/me/stars.

How Stars Work​

Toggling a star is atomic — repeated calls flip the state without risk of double-counting. The star count on registry cards updates optimistically in the UI and reconciles with the server response.

Stars are the strongest community signal in the trending ranking. See Registry & Discovery.

Reviews​

Writing a Review​

Submit a review via POST /api/appgrammars/:id/reviews:

{
  "rating": 4,
  "body": "Excellent module structure. The auth setup saved hours."
}
  • Rating is required (1-5 stars)
  • Body is optional but encouraged
  • One review per user per appgrammar (subsequent posts update the existing review via UPSERT)
  • You cannot review your own appgrammar

Viewing Reviews​

GET /api/appgrammars/:id/reviews?limit=10&offset=0

Returns reviews with author info, rating, body, and timestamps. Review count and average rating are exposed on each appgrammar for efficient display on registry cards.

Deleting a Review​

DELETE /api/appgrammars/:id/reviews

Removes your review and updates the denormalized counts.