Implement Daily Streak Tracking System (Logic + Persistence)

[phertyameen]

Description

Implement the streak tracking system logic, including persistence, updates, and timezone-safe calculations.

• API Endpoints
• GET /streaks
• POST /streaks/update

Database Schema

• Streaks
• userId
• currentStreak
• longestStreak
• lastActivityDate
• streakDates[]

Scope of Work

1. Backend Logic

• Increment streak on consecutive-day completion
• Reset streak if a day is missed
• Track longest streak
• Handle timezone-safe date comparisons

2. Frontend Streak Feature

• StreakProvider or useStreak()
• Fetch streak data
• Update streak after daily quest completion
• Expose data to UI layer

3. Suggested State Shape

{
  currentStreak: number;
  longestStreak: number;
  streakDates: string[];
  isLoading: boolean;

  updateStreak(): Promise<void>;
}

Requirements

• Persistent streak storage
• Accurate date handling
• No duplicate updates per day
• UI consumes streak data via context only

Acceptance Criteria

• Streak increments correctly
• Streak resets on missed days
• Weekly calendar reflects backend data
• Longest streak tracked
• Data persists across sessions

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[bigjoefilms]

@bigjoefilms has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’d be excited to work on this issue. I have hands-on experience building responsive React interfaces, integrating Web3 wallets, and implementing seamless UI flows for blockchain applications.

I’m available to start immediately. Thank you for considering my proposal.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @bigjoefilms to this issue.

[devchant]

@devchant has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

Hello, I’d really appreciate the opportunity to contribute to your project.

I plan to implement a centralized Daily Streak Tracking system using a StreakProvider and a useStreak hook. This system will fetch streak data from the backend, handle timezone-safe calculations to increment or reset the streak on consecutive-day completions, track the longest streak, and prevent duplicate updates within the same day. The context will expose currentStreak, longestStreak, streakDates, and a method to update the streak, allowing UI components to consume the data without directly calling APIs. All data will persist across sessions, ensuring accurate tracking and seamless integration with the frontend daily quest features.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @devchant to this issue.

[dannyy2000]

@dannyy2000 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’d like to take on this issue because a daily streak system is key to engaging users and encouraging consistent activity. Without accurate tracking, streaks could reset incorrectly, frustrating users and breaking progression rewards.

I will implement backend logic that safely increments streaks on consecutive-day completions and resets them when a day is missed. Timezone-safe date calculations will ensure that users in different regions have consistent experiences. The system will also track the longest streak and store all relevant data persistently, including streak dates.

On the frontend, I’ll expose a StreakProvider (or useStreak) that fetches the current streak, longest streak, and streak dates, and provides an updateStreak() function to be called after daily quest completion. This will allow UI components to reactively display streak progress and celebrate milestones.

I’ll include unit tests to cover consecutive-day increments, missed-day resets, and timezone edge cases to ensure reliability.

This implementation strengthens user engagement, ensures accurate progression tracking, and provides a foundation for gamified rewards.

Thanks for considering my contribution!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @dannyy2000 to this issue.

[drips-wave]

Congratulations, @bigjoefilms! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @bigjoefilms: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊