Shapes

Naming

By convention shape names should be singular. For example, a shape representing articles should be title "Article". Entering the title "Article" will also fill in the name "article". What's the difference?

  • Title - User-facing identifier for your shape
  • Name - API identifier for your shape (getArticle, createArticle, updateArticle, etc)

Modeling

Shape composition is done by drag and drop:

Simply drag the appropriate widgets from the palette on the left to the form on the right. The underlying data type of each field is inferred from the widgets you choose. 

Best Practices

  • Put your identifying fields first. Field order is important because it informs how TakeShape generates previews of your content for list views, relationships and taxonomies. Examples of identifying fields are "Title", "Name", "Headline", etc.
  • Make at least one field required.  

Annotations

In TakeShape, content modeling is meant to be as open-ended as possible. That said, you create your shapes to fulfill a specific use case. Annotations are the way to describe how your shape will be used. There are three possible values for this annotation:

  • Multiple -  Denotes multiple items. This is the default, most of your shapes will use this annotation.  E.g. Articles, Products, People, Places
  • Single - Denotes a single item or singleton in programming terminology. E.g. Homepage, Navigation, Menu, Settings 
  • Taxonomy - Denotes a shape which is used to organize others. E.g. Authors, Tags, Categories, Topics

Taxonomies

Annotating a shape as a "Taxonomy" allows the relationships between content entires to be surfaced to users when filtering in the asset views and entry list views.

Taxonomies appear in the sidebar in their own section under "Multiple' shapes.

A good taxonomy is something you'll use to classify other thing. Tags, Categories, Topics, Subjects, Genres, and even Authors. Right now the way a taxonomy is used in the UI is to help filter lists.

A taxonomy is effectively a multiple shape that we treat slightly differently on the backend. You can switch a multiple shape to a taxonomy and vice-versa at will.

Taxonomies treat their first text field as their “term” field. This is what will be used for auto suggest.

Join us

Interested in joining the team as coworker or investor?

contact@takeshape.com