Creating a Collection

Design a Collection in the builder — name, icon, color, Properties, defaults.


You can create a Collection two ways: from the chat search (fast, infers a default shape) or from the Collections builder at /collections/new (full control over Properties, defaults, and look).

This article covers the builder. For the chat shortcut, see Logging an entry.

Open the builder

Go to Collections & Tags in the sidebar (the Your collections tab), then tap New collection. A blank Collection is created for you on the spot and you land in the editor — no separate save step. Edits autosave as you go, so you can wander away whenever you're done. If you opened the page by accident and haven't touched anything, Kaizendex asks whether to keep the empty draft or delete it when you back out.

The editor has two tabs:

  • Properties — what the Collection captures (one value per Property on every Entry), the built-in Title (the headline on each Entry's card), and a live preview of an Entry of this Collection.
  • Description — a free-form markdown page where you can explain what this Collection is for, when you'd log it, what counts. It's the Collection's own little wiki page.

The name + icon at the top stay visible across both tabs.

Identity

Pick the look first — it's how the Collection will appear everywhere in the app.

  • Icon — visual anchor on every card. Click it to open the picker, then choose an emoji, a clean icon (search the library by name), or your own image — upload a file (or drag one in) or paste an image link on the Upload tab. Use something memorable.
  • Name — short and specific. Prefer "Push-ups" over "Exercise"; prefer "Morning espresso" over "Drink".
  • Color — accent for the card border and dashboard chart.

Examples:

  • 🥤 Water (blue)
  • 💤 Sleep (indigo)
  • 🏃 Run (orange)
  • 📖 Pages read (amber)
  • 🧘 Meditation (green)

Properties

Add the Properties you want to capture every time you log this Collection. For each Property pick:

  • Name — what this Property is called (e.g. reps, weight, note)
  • Kind — the data shape (see below)
  • Default value — optional; if set, one-tap logging fills it in for you

Property kinds

There are 17 Property kinds. The everyday ones:

| Kind | Use for | Examples | |------|---------|----------| | Number | Counts, weights, ratings, amounts | reps, kg, calories, rating | | Text | Short labels, names, places | note, title, place | | Markdown | Long-form notes with formatting | journal entry, session notes | | True/false | Habit completions, checkmarks | taken, completed, was productive | | Date / Date/time | A calendar day or specific moment | wake time, bedtime, due date | | Duration | A static time amount you type in | 45 min of cardio (after the fact) | | Stopwatch | Live counter (Start / Pause / Stop) | Deep work, gardening, meditation | | Timer | Stopwatch with a target | 25-min Pomodoro, breathing exercise | | Tag | Pick one coloured option from a list | mood, priority, location | | Multi-tag | Pick several coloured options | symptoms, focus areas, cuisines | | Global tag / Global multi-tag | Pick from your shared Global Tags pool | #project, #area reused across Collections | | Relation | Link to another Collection's Entry | book, project, workout | | File | Image, audio, or document | photo, voice memo, receipt | | URL / Email / Phone | Formatted text | link, contact email |

See Properties and the Title for every kind in detail with examples, and Stopwatch and Timer for the two live-tracking kinds.

A Collection can have one Property or many. Most stay small — 1 to 4 Properties is the sweet spot.

The Title row

At the top of the Properties list sits the Title — the headline that leads every Entry card. It reads like a Property row: the first column labels it "Title", and the second column holds the default title new Entries start with. Leave that default as the Collection's name to inherit it, or type something else.

Two things to keep straight:

  • The Collection's name is edited in the always-visible field at the top of the page. It's the Collection's identity — the same for every Entry.
  • The Title row's default seeds each new Entry's headline (which you then rename per Entry). Editing the default here does not rename the Collection.

You can set how wide the Title is on the card and whether it shows at all, but you can't remove it — every card has a title. To rename one Entry, open it and edit the heading at the top of its page.

Description

Switch to the Description tab to write a free-form note about the Collection itself — what it's for, when you log it, what counts as one entry, links to related Collections. It's a full markdown editor with the same slash commands, headings, lists, and tables as the entry body.

This is the wiki side of Kaizendex. Use it to leave yourself a note your future self will read when they wonder "wait — does this Collection include warm-up reps?"

A few things worth keeping in mind:

  • The Description is per-Collection, not per-Entry. It describes the Collection once; it isn't copied into entries you log.
  • It's distinct from an entry's body. The body is per-entry — the page content of one logged moment. The Description is the Collection's "About" page.
  • It's optional. Leaving it blank is fine.

A worked example

Let's build a Sleep Collection:

  1. Emoji 💤, name Sleep, color indigo.
  2. Properties:
    • hours — Number, default 7.5
    • quality — Number (1–5), default 4
    • note — Text, no default
  3. The Title defaults to Sleep — every entry's headline. Your hours Property's value shows on the card next to it.

That's it — there's no save button. Your edits land as you make them. Now every morning you can tap Sleep in the chat search and a new entry writes with hours=7.5, quality=4, note="". Tap the number cells on the resulting card to correct anything.

Editing a Collection later

Tap the Collection from the Collections board to open /collections/[id]. The page has three tabs:

  • Entries — the database table of everything you've logged for this Collection.
  • Properties — add, rename, reorder, or remove Properties; set defaults, layout width, Timer targets.
  • Description — a wiki-style note attached to the Collection itself.

From the Properties tab you can:

  • Rename the Collection — from the header field at the top of the page, or from the Title row in the list (same value, edit it either place)
  • Change emoji
  • Add new Properties (existing Entries stay valid; the new Property is empty on them)
  • Reorder Properties (the Title stays pinned at the top)
  • Resize the Title or hide it on the card — it can't be removed, though
  • Edit the Title's default — the headline new Entries start with

You can also add, rename, reorder, and delete columns directly from the database table in the Entries tab — the Properties tab is the right place for advanced per-Property settings (defaults, required toggle, layout width).

Next