About

About the Project Flux is a behavioral finance web app (mobile-first) that helps users build savings through habit tracking. Think Robinhood meets habit tracker - investment-grade UX for personal behavior change. I have a 60-70% complete React prototype. The core issue: I introduced an AI chat-first interface to replace traditional forms, and it broke data flow across the app. I need someone to fix the integration and ensure bulletproof functionality before I bring in a designer for visual polish. Key Architecture Concept The AI chat (“Flux”) is the primary user interface - not a side feature. Users interact with an accountability coach to create habits, log activities, and manage their portfolio. Traditional UI screens exist for visualization and consumption, but all user input flows through the conversational interface. This is central to the product’s differentiation. Tech Stack • React + Vite • Context API for state management (HabitContext, NavigationContext, FluxChatContext) • localStorage for data persistence • Chart.js for visualizations • Deployed on Vercel, GitHub for version control • AI integration via Anthropic Claude API What Needs to Be Fixed 1. Chat-first interface integration - AI chat is the main command center. It must successfully create habits, log activities, and trigger all state updates across the app 2. Habit logic (critical): • BUILD habits: User earns by completing activities (log required) • RESIST habits: User earns by NOT doing something (auto-earns unless failure logged) • Custom schedules: Daily, specific days, X times per week 3. Data consistency across screens: • Portfolio balance updates after every log • Habit detail pages reflect accurate history • Activity feed displays all logs correctly • Pending balance tracks weekly activity correctly 4. Money calculations: • Weekly transfer simulation (Friday transfers) • Correct earning calculations for both habit types • Balance never goes negative (users don’t lose money, only miss earning opportunities) What I Can Provide • Full codebase access (GitHub) • Working Vercel deployment • Detailed documentation: technical specs, mockups, app structure docs • Clear requirements and quick feedback • I understand the product deeply - I won’t waste your time with ambiguity Deliverable A fully functional React web app where: • Users can create BUILD and RESIST habits via chat • Users can log activities via chat • All screens reflect accurate, synced data • Money calculations are bulletproof • App works smoothly on mobile browsers Ideal Candidate • Strong React experience, especially Context API and state management • Comfortable debugging existing codebases (not starting from scratch) • Experience with chat/conversational interfaces a plus • Fintech or finance app experience a plus • Clear communicator - can explain technical decisions Budget & Timeline • Budget: $5,000-8,000 (depending on scope assessment) • Timeline: 2-3 weeks • Availability: Looking for someone who can start this month Milestone Structure: 1. Discovery/Assessment ($500-800): Review codebase, identify all issues, provide detailed scope and fixed-price quote for completion. This protects both of us from surprises. 2. Core Fixes (60% of agreed total): Chat integration working, habit logic bulletproof, data syncing correctly. 3. Final Delivery (remaining balance): Edge cases handled, mobile testing complete, documentation of changes.