Lexicon Garden

social.skyphone.spot.review

A public review of a real-world place (restaurant, cafe, shop, etc.). Designed so any AT Protocol app can read, render, and aggregate place reviews regardless of which app created them.

Repository @riyo.skyphone.social did:plc:ta347pa3wlmmyymoz56mfmfw namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityspot.skyphone.social
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

category

string

Reviewer-chosen category of the place.

  • maxLength: 64
  • knownValues: restaurant | cafe | bar | salon | clinic | hotel | gym | shop | other

createdAt

requiredstring · datetime

When this review record was created.

lang

string · language

Primary language of the review text (BCP 47).

photos

array

Photos taken at or of the place.

  • maxLength: 8
itemsblob
  • maxSize: 2000000
  • accept: image/*

place

requiredref

The place being reviewed.

Reference

rating

requiredinteger

Overall rating, 1 (worst) to 5 (best).

  • minimum: 1
  • maximum: 5

subject

ref

Optional reference to a feed post (app.bsky.feed.post) announcing this review, if the author chose to cross-post.

Reference

text

string

Free-form review body.

  • maxLength: 30000
  • maxGraphemes: 3000

visitedAt

string · datetime

When the reviewer visited the place. Clients SHOULD truncate to date precision to avoid leaking the reviewer's real-time location.

#placeRef

object

Properties

id

requiredstring

Place identifier within the source namespace.

  • maxLength: 256

latitude

string

Optional decimal latitude as a string (e.g. "35.6812"), for self-describing records.

longitude

string

Optional decimal longitude as a string (e.g. "139.7671").

name

string

Display name of the place at the time of review, so records remain human-readable even if the source registry is unavailable.

  • maxGraphemes: 300

source

requiredstring

Namespace of the place identifier. Reviews referring to the same (source, id) pair describe the same place.

  • maxLength: 64
  • knownValues: skyphone | osm | google

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • at.noted.place

    record

    A place with a review

  • com.bbq-joints.review

    record

    One person's review of a BBQ joint, held in their own repository. The reviewer owns it: they can edit or delete it, and it travels with them to any other app that reads this collection.

  • app.placita.place

    record

    A place saved by a user. The primary entity of Placita: one record per place, stored in the user's own repository.

  • us.off-the-clock.review

    record

    What a member thought of something, with a rating from 1 to 10, in a content space (D99). Members respond by replying to it, so a review heads a thread. The author edits it, rating included, by rewriting it at the same key; it sorts by createdAt, so an edit keeps its place.

  • app.attrails.review

    record

    A review of a route: a 1-5 rating, optional text, and optional photos. Activity-neutral. The AppView treats the most recent review per (author, subject) as canonical.