Parallax — How-to

Sign in

1. Hitting any /app/parallax route without a session redirects you to /app/parallax/login (with the original path preserved as ?redirect=).
2. Enter an allow-listed email + password — the preview build only accepts pre-registered accounts.
3. On success you land on the dashboard (or wherever ?redirect= pointed).

Note: A cookie called "parallax-auth" stores your email + sign-in time for 7 days. The allow-list lives in composables/useParallaxAuth.ts as { email → SHA-256 hash } pairs. Add or move to runtimeConfig.public when ready.

Sign out

1. Click the profile pill at the bottom-left of the sidebar.
2. Pick "Sign out" from the pop-up menu.

Note: Clears the parallax-auth cookie and bounces you back to the login page.

Switch context

1. Sidebar contexts are grouped under three category headers: Contexts (general work), Fitness & Health, and Chores.
2. Click any context name to make it active — it highlights in light orange.
3. The main column updates with that context's OWN tasks, dependency graph, and timer target — each context has its own list.

Note: Items, requirements, completion state, and the Pomodoro task name are all scoped per context. Categories are presentation-only — they group contexts in the sidebar but otherwise behave identically.

Rename a context

1. Click the context name (large title at the top of the main column).
2. Type the new name.
3. Press Enter to save, Esc to cancel, or click outside to save.

Note: The new name appears immediately in the sidebar.

Jump days (checkpoint viewer)

1. Click one of the three weekday segments in the day pill near the top of the sidebar (e.g. "Mon Tue Wed" if today is Tuesday).
2. A coloured banner at the top of the main column updates with that day's checkpoint.
3. Today shows the live count (orange). Yesterday shows the captured snapshot (grey). Tomorrow shows the planned state (blue).
4. When a checkpoint has a note, it appears in italic right below the banner.

Note: Pill labels are computed from the current date — hover any segment to see the relative term (Yesterday / Today / Tomorrow).

Collapse the sidebar

1. Click the panel-collapse icon at the top-right of the sidebar.
2. The sidebar shrinks to icon-only width; click again to expand.

Note: The profile pill stays anchored to the bottom-left in both states. New context, How-to, and Search sit at the top.

Open this how-to page

1. Click "How-to" near the top of the sidebar (book icon).

Note: Returns to the dashboard via the "Back to dashboard" link in the page header.

Start a new context

1. Click "New context" at the top of the sidebar.

Note: Wired to the same emit as the inline + button in the search row — currently a placeholder; will create a fresh context once the data layer lands.

Create a task

1. Type the task title in the "type to create" input.
2. Pick a deadline (date AND time) using the datetime field next to it.
3. Press Enter or click the orange + button.

Note: New tasks adopt the icon type chosen in the dropdown above. If the deadline is left blank, today at 17:00 is used.

Choose the icon type for new tasks

1. Click the dropdown labelled with the current icon (e.g. "★ Priority ▾").
2. Pick one: Priority (filled star), Goal (outline star), or Action (triangle).

Edit a task

1. Click the task title to edit it inline. Enter saves, Esc cancels.
2. Click the icon at the start of the row to cycle Priority → Goal → Action.
3. Click the countdown chip to open a quick-pick popover with four sections:
4. Total — current remaining time (live to the second) plus ±10s and ±1m nudge buttons that adjust without closing the popover.
5. From now — preset jumps: +15m / +30m / +1h / +2h / +4h.
6. Anchor — Tonight 9pm, Tomorrow 9am, +3 days, +1 week.
7. Exact — datetime picker for arbitrary dates.
8. Picking any FROM NOW / ANCHOR preset or changing the EXACT picker applies the value and closes the popover. Nudge buttons stay open so you can keep tapping.
9. Click anywhere outside the popover (or the row's edit panel, or the icon dropdown) to save & dismiss — same for the context-name editor at the top of the column.
10. Hover the row and click the pencil icon to open the full edit panel (requirements live here).

Note: Countdown auto-refreshes every 30s. Reads "deadline in 1h 20m". Tones escalate: red bold = overdue, red = within the hour, amber = within 4h, soft amber = within 24h, neutral = further out.

Mark a task complete

1. Hover the row and click the tick (○) at the far right.
2. The tick fills green (✓); the row tints darker grey and the title text mutes to grey, so done items recede visually without disappearing.
3. Click again to untick.

Note: Completed tasks still render as green nodes in the dependency graph so the dependency wave reads clearly. Only the list row is muted.

Spot what you can work on right now

1. Tasks with no unmet requirements (and not yet done) auto-highlight in light orange — both in the list and as nodes in the graph.
2. A task becomes workable as soon as every requirement it has is ticked done.
3. Done tasks are green; workable tasks are orange; everything else is neutral.

Note: No clicks needed — the highlight updates the moment dependencies are completed. Use it as a "what should I do next?" signal.

Add a requirement (task A blocks task B)

1. Open task B's edit panel (pencil icon on the row).
2. In the Requirements section, pick task A from the "+ Add requirement" dropdown.
3. Task A appears as a chip; close the edit panel with the green check.

Note: In the graph, task B now sits one level above task A with an edge between them.

Remove a requirement

1. Open the task's edit panel.
2. Click the × on a requirement chip to detach it.

Read the dependency graph

1. Bottom row: tasks with no requirements (roots).
2. Each row above depends on tasks below.
3. Lines show direct dependencies; light-orange means a chain related to the task you're editing.
4. Click any node to open that task's edit panel.

Run a Pomodoro

1. The timer's task name auto-tracks the next workable task (the orange-highlighted one in the list). Tick that task done and the timer rolls forward to the next workable item.
2. Click Start. The chip flips to "Focus" and the bar fills in deep orange.
3. When work ends, the timer auto-rolls into a Break (green).
4. Click Skip to end the current phase early; Reset returns to Idle.

Note: When nothing is workable, the timer shows "All caught up". In Detox Mode it always shows "Detox Mode" regardless.

Change Work / Break durations

1. Edit the Work and Break minute fields at the bottom of the card.
2. Changes apply on the next phase (or immediately when idle).

Enter Detox or Deep Work focus

1. At the bottom of the timer card, two launchers: Detox (blue) and Deep Work (orange).
2. Click either to enter a distraction-free overlay that darkens the entire dashboard.
3. Deep Work pins to the active task name; Detox shows "Step away. The work will wait." instead — Detox is a true break from all work, not focus on a task.
4. Each overlay carries a fresh timer (Detox: 25m relaxation; Deep Work: 90m work / 15m break) + Start/Pause + a "Back to focus" button.
5. Nothing else is clickable until you press "Back to focus" — that's the point.

Note: The overlay timer is independent of the embedded Pomodoro on the dashboard, so exiting returns you to whatever state the dashboard's timer was in.

Read the rolling timer pill

1. A small pill in the bottom-right of the screen counts down a 10-minute window.
2. When it hits 00:00 it auto-restarts — you don't have to do anything to keep the cadence going.
3. The orange ring around the time fills as the window elapses.

Note: Use it as a peripheral metronome — glance at it to sense how much of the current block remains.

Open the journal panel

1. Click the pill. A 300px panel pops out with four quick-log buttons:
2. ○ Event — something happened
3. = Feeling — energy / mood / body / mind
4. − Note — a line worth keeping
5. → Task — something to do later
6. Pick one — an input appears asking for an optional one-line note.
7. Submit with Enter (or click "Log"). Skip the note with "Skip note" to log the category only.
8. Esc cancels the active category without logging.
9. Categories you've already logged in the current 10-min window get a green tint plus a counter badge in the corner; the highlight resets when the window auto-cycles.

Read the journal log

1. Scroll "Today's log" at the bottom of the expanded panel for recent entries.
2. Each entry is prefixed with the matching marker:
3. ○ event without a note
4. ● event with a note (filled green so it stands out)
5. = feeling
6. − note
7. Each line reads: <marker> · <HH:MM> · <note if any, otherwise the category label in italic>.

Note: Log keeps the most recent 12 entries in this session. Persistence to a real journal store is TBD.

Read & adjust the 1st-wave tiles

1. 1st wave (Behaviourist) covers observable states: Energy, Mood, Sleep, Recovery (0–10 each).
2. Tap − or + on a tile to bump the score down or up. Score clamps at 0 / 10.
3. Green = 7+, amber = 4–6, red = below 4 — the band recolours as you adjust.
4. The composite score (header right) is the average and recomputes live; the delta chip shows the day-over-day change.

Log a thought record (2nd wave)

1. Click the 2nd tab at the top of the Behaviour Monitor.
2. Fill in A (activating event), B (belief / thought), C (consequence) inline.
3. Click "Log thought record" — it appears at the top of the list with a timestamp.

Note: CBT-style A→B→C records help you notice the cognitive link between event and reaction. Capture them in the moment, then reframe later.

Track values alignment & mindful minutes (3rd wave)

1. Click the 3rd tab at the top of the Behaviour Monitor.
2. Each top value (Craft, Health, Connection by default) gets a 0–10 alignment score with a green progress bar.
3. Tap − or + to bump the score; the bar fills accordingly.
4. Mindful minutes for the day appears at the bottom in a blue badge.

Note: ACT / mindfulness-style tracking — focuses on values alignment and presence rather than symptom suppression.

Coach's experiment hint (3rd wave)

1. When the 3rd wave tab is open, the coach's suggested experiment shows in italic at the bottom.
2. It updates from the same audit feed that powers the composite score.

Note: The verbose "Top Context Switches" + full coach's note view from the previous design has been retired to keep the panel compact. Bring it back as a dedicated reflection page if needed.

Switch to Agents Focused

1. Click "Switch to Agents" above the panel.
2. The card swaps to active agents with their statuses and a chat input.