Peaky TwinsPeaky Twins
Help

Search Help Documentation

Challenges

Challenges are time-boxed, shared activities you take on together with your partner. Unlike Goals — which are personal and self-paced — Challenges have a defined start and end date and involve both partners from the moment they are created.

What is a Challenge?

A Challenge is a time-boxed, shared activity with a defined startDate and endDate. It is created by one partner but both partners participate — each partner is recorded as a challengeParticipant on the challenge record.

Challenges are designed for mutual accountability: both partners work toward the same goal within the same time window, and each can see how the other is progressing.

Time-Boxing: Start and End Dates

Every Challenge has a startDate and an endDate. These dates define the window during which the Challenge is active. Tasks belonging to the Challenge are expected to be completed within this window.

This is the key structural difference from Goals, which have no end date and are entirely self-paced.

Created by One, Shared by Both

A Challenge is created by one partner, but both partners are automatically added as challengeParticipants. This means both partners have full access to the Challenge and its tasks from the moment it is created — no separate acceptance step is required.

Either partner can view the Challenge details, see the task list, and track progress for both participants.

Independent Completion with Mutual Visibility

Both partners complete the same Challenge Tasks independently. Each partner's completion is recorded separately — completing a task marks it done only for you, not for your partner.

At the same time, each partner can see the other's completion progress. You can see how many tasks your partner has completed, and they can see yours. This mutual visibility is what makes Challenges a tool for accountability rather than just a shared to-do list.

One Challenge, One View

Because a Challenge involves both partners, it could theoretically appear twice in a partnership view — once for the creator and once for the other participant. Peaky Twins prevents this by fetching Challenges for the full partnership and deduplicating them.

A Challenge appears exactly once in the partnership view, regardless of which partner created it.

Example

Suppose you and your partner want to build a meditation habit together. You create a Challenge: “Let's both meditate every day for 30 days.”

  • startDate: June 1 — endDate: June 30
  • Both you and your partner are added as challengeParticipants automatically.
  • The Challenge includes a daily task: “Meditate for 10 minutes.”
  • Each day, you mark the task complete for yourself. Your partner does the same independently.
  • You can see your partner's daily completions, and they can see yours — keeping both of you accountable throughout the month.
  • The Challenge appears once in both your views, not twice.