Family Sharing

Pulse supports family sharing, allowing a small group to collaborate on shared projects and tasks while keeping personal data private. This guide covers how to create a family, invite members, share projects, and manage assignments.

Creating a Family

Any Pulse user can create a family. A family has:

• A name (e.g., "The Smiths" or "Home Projects")
• An owner — the user who created it
• A maximum of 5 members (including the owner)
• A unique invite code generated automatically

The owner is automatically added as the first member with the owner role.

Inviting Members

When you create a family, Pulse generates a unique invite code. Share the invite link with the people you want to join:

https://pulsegtd.app/join/[invite-code]

The invite code is a UUID, so links look like:

https://pulsegtd.app/join/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Send this link to family members via text, email, or however you prefer. Anyone with a Pulse account who visits the link can join the family.

Joining a Family

When a user visits the invite link at /join/[code]:

1. They are prompted to sign in (if not already authenticated)
2. The family name is displayed with a confirmation prompt
3. Upon accepting, they are added as a member of the family
4. They immediately gain access to all projects shared with the family

A user can only belong to one family at a time.

Sharing Projects

Once a family exists, any member can share their projects with the family:

• Navigate to a project's settings
• Select the option to share with your family
• The project and all its tasks become visible to every family member

Sharing is managed through the projectSharing table, which links a project to a family. Sharing can be revoked at any time by the project owner.

What Sharing Enables

• All family members can view tasks in the shared project
• Tasks can be assigned to specific family members via the assigneeId field
• Members can create tasks within shared projects
• Members can complete tasks assigned to them

Task Assignment

In shared projects, tasks gain an assigneeId field:

When a task is assigned to a family member, it appears in their personal task views (Today, Tomorrow, Inbox) alongside their own tasks. This lets each person maintain a single unified task list while participating in shared projects.

Assigning Tasks

You can assign tasks when creating or editing them within a shared project. Select a family member from the list of people in your family.

Privacy Boundaries

Family sharing is designed with clear privacy boundaries. The following data is always private and never shared with family members:

Family members cannot see each other's dashboards, analytics, or any data outside of shared projects.

Owner Capabilities

The family owner has additional management capabilities:

Regenerate Invite Code

If an invite link is compromised or you want to invalidate the old one, the owner can regenerate the invite code. The previous code immediately stops working, and a new link is generated.

Remove Members

The owner can remove any member from the family. When a member is removed:

• They lose access to all shared projects immediately
• Their task assignments are cleared in shared projects — any task where they were the assigneeId has that field set to null
• Their personal data (tasks, habits, reviews) is unaffected
• They can be re-invited later with a new invite link

Limits and Constraints

Common Workflows

Household Task Management

Create a "Household" project, share it with your family, and add tasks like groceries, chores, and errands. Assign tasks to specific family members so everyone knows their responsibilities.

Shared Goals

Create a project for a family goal (e.g., "Plan vacation" or "Home renovation"). Break it into tasks, assign owners, and track progress together through the shared project view.

Collaborative Projects

For families that work together, share work-related projects. Each person sees their assigned tasks in their personal Today view, making it seamless to balance personal and shared work.