Skip to content

Conversation

@bestfriendai
Copy link

No description provided.

claude and others added 8 commits December 20, 2025 20:16
- Add Gemini 2.0 Flash AI service for room analysis and task generation
- Create DeclutterContext for global state management with AsyncStorage persistence
- Implement onboarding flow with API key setup and user profile creation
- Build home dashboard with room cards, quick actions, and stats overview
- Create room detail screen with task management, progress tracking, and photo gallery
- Add camera screen with room type selection and photo capture
- Implement AI analysis screen with task breakdown and encouragement messages
- Build progress screen with badges, levels, XP, and streak tracking
- Add settings screen with AI configuration and ADHD-friendly options
- Include gamification elements: 10+ achievement badges, streak tracking, and level progression
- Remove unused demo components and fix TypeScript errors

Features designed with ADHD-friendly principles:
- Small, manageable task steps with time estimates
- Quick wins section highlighting tasks under 5 minutes
- Encouraging, non-judgmental AI messages
- Visual progress tracking with gauges and percentages
- Gamification to boost dopamine and motivation
Focus Mode:
- Full-screen focus timer with countdown and progress tracking
- Strict mode prevents early exit with warning modal
- App state detection for distraction attempts
- Pause/resume functionality with +5 min extension
- Motivational quotes rotation during sessions
- XP bonus for completed focus sessions
- Animated timer with pulse effect

Mascot System (Tamagotchi-style):
- 4 personality types: Spark, Bubbles, Dusty, Tidy
- Dynamic mood states based on user activity
- Hunger, energy, happiness stat tracking
- Interactive animations (bounce, dance, celebrate)
- Speech bubbles with contextual messages
- Mascot selection during onboarding
- Dedicated mascot detail page with stats

AR Collectibles:
- 20+ collectible items across 5 categories
- Rarity system: common, uncommon, rare, epic, legendary
- Items spawn when completing tasks
- Animated collection overlay with tap-to-collect
- Collection gallery with filtering by category
- XP rewards based on rarity
- Progress tracking for unique items collected

Home Screen Updates:
- Quick action buttons for Camera, Focus, Collection
- Mascot widget with mood-based messages
- Collection stats display
- Collectible spawn overlay integration
- Focus Mode: Add breathing particles, segmented progress ring,
  dynamic gradient colors, completion celebration screen, and
  improved timer with pill-style stats
- CollectibleSpawn: Add particle celebration effects, ring pulse,
  rarity glow, background dim for rare items, and progress timer bar
- Mascot: Add sparkle effects, glow animations, mood indicator dot,
  level badge, compact emoji stat bars, and enhanced activity animations
- Focus Mode settings: strict mode, motivational quotes, auto-start breaks, block notifications
- Collection settings: AR collectibles toggle, collectible notifications
- Remove unused liquid-glass components and unused files
- Implement clearAllData function for settings data reset
- Add dynamic motivation quotes to Home screen with AI fallback
- Add break timer feature to Focus Mode with skip option
- Enhance API key validation in settings with real-time testing
- Update to Gemini 3.0 Flash API (latest model)
- Add comprehensive Firebase backend integration documentation
- Add resetStats action to context for data management
## Onboarding Improvements
- Add guest mode for immediate testing without account
- Add sign-in placeholder (Google, Apple, Email) for Firebase integration
- Improve onboarding copy to explain photo AND video support
- Add skip options for faster onboarding
- Better mascot selection with automatic name fallback

## Camera Improvements
- Fix preview to show actual captured image using expo-image
- Add video capture support (30 sec max)
- Add video indicator badge on preview
- Improve preview UI with room tags and better buttons
- Add haptic feedback on capture

## AI/Cleaning Instructions (Major)
- Completely rewrite Gemini system prompt with expert cleaning knowledge
- Add specific instructions for each type of mess (dishes, clothes, papers, etc.)
- Include WHERE and HOW in every task description
- Add detailed subtasks (1-3 min each) for every task
- Improve default tasks with comprehensive step-by-step instructions
- Add "Make the Bed" task as a high-impact quick win
- Include cleaning tips like "wipe from back to front"

## Code Quality
- Add proper error handling with user-friendly alerts
- Add Haptics import and feedback throughout
- Better state management for media capture
- Support both photos and videos in analysis flow
- Room Detail: Add Focus Mode quick-start button, task completion
  celebration animations with confetti overlay
- Analysis Screen: Add polished loading state with image preview,
  scanning animation, progress stages, and visual feedback
- Progress Screen: Add weekly activity chart visualization with
  streak banner and animated bar graph
- Home Screen: Enhanced empty state with engaging illustration,
  feature steps, and clear CTAs for new users
- Collection Screen: Add motivating empty state to encourage
  task completion for collectible unlocks
- Room Detail: Improved no-tasks empty state with AI analysis
  feature highlights

All improvements maintain ADHD-friendly design principles with
clear visual feedback, celebration moments, and progressive disclosure.
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +829 to +833
export function useDeclutter() {
const context = React.use(DeclutterContext);
if (!context) {
throw new Error('useDeclutter must be used within a DeclutterProvider');
}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P0 Badge Fix useDeclutter to use useContext

useDeclutter calls React.use(DeclutterContext), but React exposes useContext, not use, so this hook fails to compile/throws as soon as the app tries to read the context. Because every screen imports useDeclutter, the app cannot render until the hook uses useContext(DeclutterContext) instead.

Useful? React with 👍 / 👎.

Onboarding:
- Simplified to 3 quick swipeable tutorial slides
- Removed lengthy auth flow (now purely local storage)
- Combined name + mascot into single quick setup screen
- Added animated pagination dots
- Streamlined to get users started faster

Documentation:
- Added complete DOCUMENTATION.md with:
  - Full feature overview
  - Architecture details
  - Screen-by-screen breakdown
  - AI integration guide
  - Data management reference
  - Gamification system details
  - Video support documentation
  - Troubleshooting guide
  - API reference

The onboarding now takes ~30 seconds instead of several minutes,
focusing on quick value delivery while still introducing core features.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants