🙋♀️ Chore Claiming System
Enable household members to take initiative by claiming unassigned chores when they're ready to help!
Overview
The chore claiming system allows household members to self-assign chores that haven't been specifically assigned to anyone yet. This promotes responsibility and helps distribute household tasks fairly when members are available to contribute.
Key Benefits
- Empowers initiative: Members can step up when they're available
- Reduces coordination overhead: No need to manually assign every chore
- Promotes fairness: Anyone can claim available chores
- Instant feedback: Visual confirmation when chores are claimed
How It Works
When chores are created without specific assignments, they appear in the "Unassigned Chores" section where any household member can claim them with a single click.
Getting Started
Prerequisites
- Household setup: Must be part of a household with multiple members
- Unassigned chores: At least one chore must exist without assignments
- Member permissions: All household members can claim unassigned chores
Basic Claiming Workflow
-
View Available Chores
- Open the chores section in Mind Your Now
- Look for the "Unassigned Chores" section
- Available chores show a "Claim" button
-
Claim a Chore
- Click the blue "Claim" button next to any unassigned chore
- The chore immediately moves to your "My Chores" section
- You'll see a success notification confirming the claim
-
Complete the Chore
- Work on the chore as usual
- Mark it complete when finished
- The chore will reflect your completion in household progress
User Interface Guide
Chores Section Layout
The chores interface is organized into three main sections:
1. My Chores
- Shows chores assigned specifically to you
- Displays completion status and due dates
- No claim buttons (already yours)
2. Today's Chores
- Shows all household chores for the current date
- Includes both assigned and unassigned chores
- Mixed view for household coordination
3. Unassigned Chores
- Shows chores available for claiming
- Features prominent "Claim" buttons
- Updates in real-time as chores are claimed
Claim Button States
| State | Appearance | Action Available |
|---|---|---|
| Available | Blue "Claim" button | Click to claim chore |
| Claimed | Button disappears | Chore moves to "My Chores" |
| Processing | Disabled button | Wait for claim to complete |
Visual Feedback
- Success toast: Displays "🙋♀️ Claimed [Chore Name]!" with thank you message
- Real-time updates: Chore immediately disappears from unassigned list
- My Chores update: Claimed chore appears in your personal list
- Gradient styling: Success message uses blue gradient for positive reinforcement
Advanced Features
Real-Time Synchronization
Claims are synchronized instantly across all devices:
- WebSocket updates: Other family members see changes immediately
- Conflict prevention: If two people try to claim the same chore, first claim wins
- Automatic refresh: Lists update without page reload
Assignment Types Integration
The claiming system works with all chore assignment types:
- Individual chores: One person claims and completes
- Shared chores: Multiple people can claim the same shared chore
- Rotational chores: Claims respect rotation order
Mobile Experience
- Touch-optimized: Claim buttons sized for easy mobile interaction
- Responsive layout: Three-section layout adapts to mobile screens
- Swipe compatibility: Claiming works with mobile gesture navigation
API Integration
Claiming Endpoint
Claims are processed through the unified tasks API:
PUT /api/v2/unified-tasks/{choreId}/assignments
Authorization: Bearer {token}
Content-Type: application/json
{
"addMembers": ["member-uuid"],
"assignmentType": "INDIVIDUAL"
}
Response Handling
- Success: Chore assignment created with member details
- Conflict: Error if chore already claimed by assignment limit
- Authentication: Requires valid household member token
Real-Time Events
WebSocket events keep all clients synchronized:
CHORE_ASSIGNED: Broadcasts when chore is claimed- Event includes member name and chore title for notifications
Troubleshooting
Common Issues
Claim button not appearing:
- Verify you're a household member with proper permissions
- Check that the chore is truly unassigned (not in rotation queue)
- Refresh the page if WebSocket connection is stale
Claim fails with error:
- Another member may have claimed it first
- Check your internet connection
- Verify you're still logged in to your household
Chore doesn't move to My Chores:
- Wait a moment for real-time synchronization
- Pull down to refresh on mobile
- Check if the chore has specific assignment requirements
Error Messages
| Error | Cause | Solution |
|---|---|---|
| "Member is already assigned" | You already have this chore | Check "My Chores" section |
| "Chore not found" | Chore was deleted | Refresh the chore list |
| "Not authenticated" | Session expired | Log in again |
Performance Tips
- Network connectivity: Claims require internet connection
- Background sync: Changes sync when connection restored
- Cache updates: Recent claims cached for offline viewing
Mobile-Specific Features
Touch Interactions
- Large touch targets: Claim buttons sized for thumb interaction
- Haptic feedback: Subtle vibration on successful claim (iOS/Android)
- Pull-to-refresh: Swipe down to manually refresh unassigned chores
Responsive Design
- Stacked layout: Sections stack vertically on narrow screens
- Scroll optimization: Each section independently scrollable
- Button placement: Claim buttons positioned for one-handed use
Household Management
Admin Controls
Household administrators can:
- View who claimed which chores in the activity feed
- Create chores without assignments to enable claiming
- Adjust chore settings that affect claim eligibility
Member Permissions
All household members have equal claiming rights:
- No hierarchy for claiming (first-come, first-served)
- Claims respect existing chore constraints (time windows, difficulty)
- Member roles don't affect claiming ability
Fair Distribution
The system promotes fairness by:
- Making all unassigned chores visible to everyone
- Providing equal opportunity for all members
- Tracking completion patterns for household insights
Best Practices
For Families
- Encourage initiative: Praise members who proactively claim chores
- Create available chores: Leave some chores unassigned for claiming
- Set expectations: Establish household norms about claiming vs. assignment
For Roommates
- Rotation balance: Mix claimed chores with assigned rotations
- Communication: Use chore notes to coordinate complex tasks
- Flexibility: Allow claims on traditionally assigned chores when appropriate
For Organizations
- Shift flexibility: Enable staff to claim open shifts/tasks
- Skills matching: Create claiming pools for different skill levels
- Recognition: Track and celebrate proactive claiming behavior
What's Next?
The claiming system integrates with other Mind Your Now features:
- Achievement tracking: Claims count toward completion achievements
- Analytics: View claiming patterns in household insights
- Notifications: Get alerts when family members claim chores
- Calendar sync: Claimed chores appear in your personal schedule
Ready to encourage more household participation? Start by creating some unassigned chores and let your family members discover the claiming system naturally!