Skip to content

steven-the-qa/funger

Repository files navigation

Funger: Making Hunger Fun

About Funger

Funger transforms the challenging experience of dieting into a fun, rewarding journey. By gamifying hunger tracking, Funger helps you visualize progress, earn rewards, and build healthy habits while managing your calorie-restricted diet.

Why Track Your Hunger?

Dieting is challenging, and hunger can be one of the most difficult aspects to manage. Funger helps you:

  • See your progress: Watch as your hunger episodes become shorter and less frequent over time
  • Identify patterns: Discover when you tend to get hungry throughout the day
  • Stay motivated: Get visual proof that your body is adapting to your new eating patterns
  • Earn rewards: Turn your consistency into virtual cookies and garden items

Features

🍽️ Hunger Tracking

With just a single tap, you can:

  • Mark when you start feeling hungry
  • Record when your hunger subsides
  • Automatically calculate the duration of each hunger episode

📊 Visualize Your Journey

Funger provides helpful visualizations:

  • Chart your hunger episodes over time
  • View a trend line showing how your hunger patterns are changing
  • See if your body is adapting to your diet plan
Screenshot 2025-03-14 at 6 23 32 PM

🍪 Cookie Rewards System

Stay motivated with a sweet (virtual) reward system:

  • Earn cookies for completing hunger tracking
  • Build streaks by consistently tracking your hunger
  • Unlock cookie achievements for milestones
  • Share your cookie collection on social media
Screenshot 2025-03-14 at 6 23 49 PM

🌱 Touch Grass Garden

Take healthy breaks from screen time:

  • Complete 30-minute "Touch Grass" sessions to earn Daisies
  • Plant and grow a variety of plants in your virtual garden
  • Upgrade plants from basic to rare, epic, and legendary variants
  • Place ornaments to personalize your garden space
  • Track your progress with a garden that visually represents your healthy habits
Screenshot 2025-03-14 at 6 24 07 PM

🏆 Garden Inventory System

Manage your growing collection:

  • View all owned plants in your inventory
  • Return plants to inventory to reposition them
  • Place multiple plants of the same type based on your inventory count
  • Earn special ornaments through challenges to decorate your garden
Screenshot 2025-03-14 at 6 26 07 PM

📱 User-Friendly Interface

  • Clean, minimalist design
  • Simple one-tap tracking
  • Secure user authentication
  • Social sharing capabilities
  • Responsive layout for all device sizes

Plant Collection

Your garden can grow a variety of plants with four rarity levels: basic, rare, epic, and legendary.

🌼 Flowers

  • Daisy (Basic, earned from Touch Grass sessions)
  • Cherry Blossom (Rare)
  • Hibiscus (Epic)
  • Rose (Legendary)

🥕 Vegetables (Cost: 5 Daisies for basic)

  • Carrot (Basic)
  • Broccoli (Rare)
  • Corn (Epic)
  • Eggplant (Legendary)

🍎 Fruits (Cost: 10 Daisies for basic)

  • Apple (Basic)
  • Pear (Rare)
  • Strawberry (Epic)
  • Peach (Legendary)

🌳 Trees (Cost: 15 Daisies for basic)

  • Oak Tree (Basic)
  • Pine Tree (Rare)
  • Palm Tree (Epic)
  • Festive Tree (Legendary)

🍀 Lucky Charms (Cost: 20 Daisies for basic)

  • Lucky Clover (Basic)
  • Big Lucky Clover (Rare)
  • Grand Lucky Clover (Epic)
  • Legendary Lucky Clover (Legendary)

Garden Ornaments

Personalize your garden with special decorative items:

Common Ornaments (50% chance)

  • Garden Rock
  • Mushroom

Uncommon Ornaments (30% chance)

  • Fountain
  • Garden Bench

Rare Ornaments (15% chance)

  • Garden Gnome
  • Pink Flamingo

Epic Ornaments (4% chance)

  • Garden Statue
  • Garden Pond

Legendary Ornaments (1% chance)

  • Golden Statue
  • Rainbow Fountain

Ornaments are awarded randomly upon completing Touch Grass challenges, with rarity determined by the probability distribution above. The longer your streak of completed Touch Grass sessions, the slightly higher your chances of receiving rarer ornaments!

Tech Stack

Funger is built with modern web technologies:

  • Frontend: React 18 with TypeScript
  • UI Framework: Tailwind CSS for responsive design
  • Backend: Supabase for authentication, database, and storage
  • Charting: Chart.js with react-chartjs-2 for data visualization
  • Image Generation: html2canvas for social sharing features
  • State Management: React Context API and custom hooks
  • Deployment: Netlify with continuous deployment
  • Dev Tools: Vite, ESLint, TypeScript

The Science Behind Funger

When you diet, your body eventually adapts to new eating patterns. Funger helps you track this adaptation while using proven behavioral psychology techniques:

  • Gamification: Makes the challenging process of dieting more engaging
  • Visual Progress: Provides tangible evidence of your consistency
  • Reward Systems: Reinforces positive habits with virtual rewards
  • Screen Breaks: Promotes healthy balance with technology

Funger: Where cravings earn cookies and breaks grow gardens

About

Measure how long you're hungry

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published