Skip to content

Your first collection

You will make a Workouts collection, give it three properties, and log “Morning run, 5.2 km”.

Steps 1 and 2 make the shape of your data: the collection and its properties. This shape is also called the schema: the plan of what each entry holds. Step 3 adds the data: an entry, with one value for each property.

  1. Make the collection. Create a new collection and name it Workouts. Pick an icon if you like. It shows in the Collections part of the sidebar.

    A new collection starts with one Block page property, called Document. It is where you write, and it can also hold photos and charts. Keep it for notes about each workout, or rename or remove it.

  2. Add three properties.

    Property Type Setting
    Distance Number unit: km, one decimal
    Duration Number format: duration
    Type Tags tags: Run, Gym, Swim

    Tags come from one pool for the whole app, so the tag “Run” is the same tag everywhere.

  3. Log an entry. In Workouts, click New workout. Type the title Morning run, Distance 5.2, Duration 28 min, and Type Run. These are the entry’s values.

    Every entry also has three built-in dates. The Entry date is when it happened; it is never empty, and you can change it if the run was yesterday. Created at and Updated at are set by the app.

  4. See it. The run shows in the Workouts table at once. Every entry in Workouts shows there, unless you add a filter.

Where it went

With the desktop app, your entry is now a file you can open in any text editor. The values sit at the top. The Block page is the text below. A shortened example:

Kaizendex/Collections/Workouts/Morning run.md
---
title: Morning run
distance: 5.2
---
Felt easy. Legs fresh after the rest day.

Edit the file and the app takes the change in, checked and undoable. The exact spelling of every value is on Folder format.