HabitForge - Support & Help Center

Getting Started

First Time Setup

System Requirements:

iOS 14.0 or later
iPhone or iPad with sufficient storage (recommended: 500MB free space)
Internet connection for AI features (Google Gemini AI)
iCloud account (optional, for data sync across devices)

Initial Setup Steps:

Download HabitForge from the App Store
Open the app and grant necessary permissions when prompted
Create your first habit or expense category
Set up your budget goals (optional)
Add the iOS widget to your home screen for quick access

Frequently Asked Questions (FAQ)

Q: How does the AI-powered habit tracking work?

A: HabitForge uses Google Gemini AI to analyze your habit completion patterns and provide personalized recommendations. The AI learns from your behavior and suggests optimal times to complete habits, identifies patterns, and offers motivational insights.

Q: Can I track expenses using natural language?

A: Yes! Simply type natural language entries like "Bought coffee for $5" or "Lunch $12.50" and HabitForge will automatically parse the amount and categorize it. The AI understands various formats and currencies.

Q: How do iOS widgets work?

A: HabitForge provides native iOS widgets that allow you to complete habits and log expenses directly from your home screen without opening the app. Widgets update in real-time and sync with the main app.

Q: What is the gamification system?

A: The gamification system includes:

Character Leveling: Level up your character as you complete habits
Quests: Daily and weekly quests with rewards
Achievement Badges: Unlock badges for milestones and streaks
Streaks: Track consecutive days of habit completion
Mini-Games: Fun interactive games tied to your progress

Q: How does budget tracking work?

A: HabitForge provides intelligent budget tracking with:

Real-time spending monitoring
Category breakdowns and visualizations
Financial health score based on your spending patterns
Budget alerts and recommendations

Q: Can I sync data across multiple devices?

A: Yes, HabitForge supports iCloud sync to keep your data synchronized across all your iOS devices. Make sure you're signed into the same iCloud account on all devices.

Q: How do I add a widget to my home screen?

A:

Long press on your home screen
Tap the "+" button in the top left corner
Search for "HabitForge"
Select the widget size you prefer
Tap "Add Widget" and position it on your home screen

Q: Can I export my data?

A: Yes, you can export your habit and expense data. Go to Settings → Export Data to generate a CSV file with all your information.

Troubleshooting

Widget Issues

Problem: Widget not updating

Try removing and re-adding the widget
Restart your device
Ensure the app has background refresh enabled in iOS Settings

Problem: Widget shows incorrect data

Open the main app to refresh data
Check that you're signed into the same iCloud account
Update to the latest version of HabitForge

AI Features

Problem: AI recommendations not appearing

Ensure you have an active internet connection
Complete at least a few habits to give the AI data to analyze
Check that AI features are enabled in Settings

Sync Issues

Problem: Data not syncing across devices

Verify you're signed into the same iCloud account on all devices
Check iCloud Drive is enabled in iOS Settings
Ensure both devices have sufficient iCloud storage
Try signing out and back into iCloud on one device

Performance Issues

Problem: App is slow or laggy

Close other apps to free up memory
Restart your device
Update to the latest iOS version
Clear app cache by deleting and reinstalling (make sure to export data first)

Expense Tracking

Problem: Natural language parsing not working correctly

Try rephrasing your entry (e.g., "$5 coffee" or "coffee $5")
Ensure the amount is clearly stated with a dollar sign or number
Manually edit the entry if parsing is incorrect

Tips & Best Practices

Habit Tracking

Start Small: Begin with 2-3 habits to build consistency
Set Realistic Goals: Choose habits you can realistically complete daily
Use Reminders: Set up notifications to remind you of your habits
Review Weekly: Check your progress and adjust habits as needed
Leverage AI: Pay attention to AI recommendations for optimal timing

Expense Management

Log Immediately: Enter expenses right after making a purchase
Use Natural Language: Take advantage of the AI parsing feature
Set Budget Limits: Create realistic budget goals for each category
Review Regularly: Check your financial health score weekly
Category Organization: Use consistent category names for better tracking

Gamification

Complete Daily Quests: Focus on daily quests for consistent rewards
Maintain Streaks: Keep your streaks alive for bonus points
Unlock Achievements: Work towards achievement badges for motivation
Level Up: Complete habits consistently to level up your character

Widget Usage

Quick Actions: Use widgets for one-tap habit completion
Fast Expense Entry: Log expenses directly from the home screen
Progress Tracking: Keep an eye on your daily progress without opening the app

Technical Support

Before Contacting Support

Please try these steps first:

Restart the app
Restart your device
Update to the latest version of HabitForge
Update to the latest iOS version
Check this support page for your specific issue

Contact Information

Email Support: support@ryanyang05.me

Response Time: We aim to respond within 24-48 hours

When contacting support, please include:

Your device model (e.g., iPhone 13 Pro)
iOS version
HabitForge app version
Detailed description of the issue
Steps to reproduce the problem
Screenshots or screen recordings (if applicable)

Known Limitations

AI features require an active internet connection
Widget updates may have a slight delay (usually less than 1 minute)
Natural language parsing works best with clear, simple statements
iCloud sync requires sufficient iCloud storage space
Some older iOS devices may experience slower performance with large datasets

App Information

Version: Check App Store for current version
Compatibility: iOS 14.0+
Languages: English
Privacy: All data stored locally or in your iCloud account. No data shared with third parties except Google Gemini AI for habit recommendations (data is processed securely and not stored by Google)

Download on App Store