Concepts
API documentation
Account management
Journals
Modules
Modules
JournalOS lets users write journal entries. Each journal entry follows a layout, which itself is made of modules. Modules are sets of fields that can be used to capture specific data.
Categories
JournalOS organizes modules into five core categories. We don't want to have more categories - it forces us to think about the different aspect of our lives in a simpler manner.
Every module must clearly answer the question: Which part of my life does this describe? . If a module does not fit cleanly into one of these five, it likely does not belong in JournalOS.
Category overview
πͺ Body & Health
What it represents
The physical state of the user and the biological constraints that shape the day.
What it brings
This category captures signals that strongly influence everything else but are often invisible in hindsight: fatigue, recovery, illness, physical strain. It provides grounding context for mood, performance, and decisions.
π§ Mind & Emotions
What it represents
The internal, subjective experience of the day: mood, stress, attention, and mental bandwidth.
What it brings
It explains how the day was lived, not just what happened. Capturing mental and emotional state makes patterns visible over time and clarifies limits, triggers, and recovery needs.
πΌ Work
What it represents
Structured effort and obligations: what you had to do, what you chose to do, and what you produced.
What it brings
It separates progress from noise. Work tracking in JournalOS focuses on leverage, friction, control, and trajectory so you can understand whether your time compounds or gets consumed by busywork.
π₯ Social
What it represents
Human interactions and relational dynamics: who you were around and how those interactions affected you.
What it brings
Social context is often the hidden driver behind mood, energy, and decisions. This category makes relationship patterns visible without turning JournalOS into a social network or a heavy CRM.
π Places
What it represents
Environmental and spatial context: where you were and the conditions around you.
What it brings
Place acts as a silent modifier of behavior and wellbeing. Logging environment provides strong explanatory context when reviewing periods, especially for routines, travel, and seasonal effects.