User Guide

Master your household management with Kavanoz

Getting Started

Creating an Account

You can sign up using Email & Password, Google Account, or Apple ID (iOS only).

  1. Tap "Sign Up" or "Create Account"
  2. Enter your email address
  3. Create a strong password (minimum 8 characters)
  4. Accept Terms of Service and Privacy Policy
  5. Tap "Create Account"
  6. Check your email and verify your email address (required to sign in)

Creating a Home

After signing up, you can create your digital home:

  1. Open the app and sign in
  2. Tap "Create New Home"
  3. Enter a name (e.g., "Our Sweet Home")
  4. Tap Save

Joining a Home

To join an existing home:

  1. Ask a household member for the Invite Code (found in Profile β†’ Shared Home)
  2. Tap "Join Existing Home"
  3. Enter the 8-character code
  4. Tap Join to instantly connect
πŸ’‘ Important:

Email verification is mandatory. You must verify your email address before you can sign in to your account. Check your inbox (and spam folder) for the verification email.

Dashboard (Home Tab)

Your daily command center showing everything that matters at a glance.

Daily Summary

The main card shows your progress for the day: completed routines (e.g., "5/13"), upcoming bills, and active lists. Tap on any section to navigate directly to that feature.

Dashboard Widgets

The dashboard displays helpful widgets:

  • Personal Budget Widget - Shows your monthly spending vs. budget with visual progress
  • Savings Widget - Total savings across all currencies and assets
  • Shared Home Widget (Premium) - Shows shared home status and member count
  • Debt Summary Widget (Shared Home) - Shows who owes what in your shared home

Quick Actions

Use the + button (floating action button) to quickly add routines, bills, expenses, documents, or list items. Navigate between tabs using the bottom navigation bar.

Routines

Build and maintain daily, weekly, and monthly habits.

Creating a Routine

  1. Navigate to the Routines tab
  2. Tap the + button
  3. Enter title (e.g., "Morning Exercise")
  4. Choose category (Kitchen, Bathroom, Living Room, etc.)
  5. Set frequency (Daily, Weekly, or Monthly)
  6. Set reminder time
  7. Choose icon & color
  8. Tap Save

Completing Routines

Tap the checkbox next to a routine to mark it complete. Your streak counter increases automatically! Streaks track consecutive days of completion.

Streak Tracking

Build momentum with streak tracking:

  • Your streak counter shows consecutive days of completion
  • Celebrate milestones at 7, 30, and 100 days
  • Get recovery reminders if you miss a day
  • View your longest streak in routine details

Free Tier Limits

Free users can create up to 5 active routines. Premium users have unlimited routines.

πŸ’‘ Tip:

Premium users can browse 60+ preset routines tailored to household needs. This saves time and helps you discover new habits!

Finance & Budget

Track bills, expenses, budgets, and savings all in one place.

Adding a Bill

  1. Go to Finance β†’ Bills
  2. Tap the + button
  3. Enter bill name (e.g., "Electricity")
  4. Enter amount
  5. Set next due date
  6. Choose payment cycle (Monthly, Yearly, One Time)
  7. Mark as "Shared" if using Shared Home (Premium)
  8. Tap Save

Adding an Expense

  1. Go to Finance β†’ Bills tab (expenses are shown in the same list)
  2. Tap +
  3. Enter amount and description
  4. Select date
  5. Choose category (Food, Transport, Shopping, Entertainment, Health, etc.)
  6. For shared expenses (Premium): Select who paid and how to split (Equally or Custom)
  7. Mark as "Shared" if using Shared Home (Premium)
  8. Tap Save

Expense Splitting: In Shared Homes, you can split expenses equally or set custom amounts per person. The app automatically calculates who owes what.

Setting Your Budget

  1. Go to Finance β†’ Budget tab
  2. Tap "Set Personal Budget"
  3. Enter monthly budget amount
  4. Tap Save

You'll receive alerts at 80%, 100%, and 120% of your budget. The budget widget on your dashboard shows your progress visually.

Savings Tracking

Track your savings in multiple currencies, gold, and silver all in one place.

  1. Go to Finance β†’ Savings tab
  2. Tap the + button
  3. Choose type: Currency, Gold, or Silver
  4. Enter amount (for currency) or weight in grams (for gold/silver)
  5. Add optional label (e.g., "Emergency Fund")
  6. Tap Save

All savings are automatically converted to your preferred currency. Gold and silver prices are fetched from real-time APIs (if configured) or can be set manually.

Savings Goals

Set and track savings goals:

  1. Go to Finance β†’ Savings tab
  2. Tap "Savings Goals" or find it in the savings screen
  3. Tap "Add Savings Goal"
  4. Choose goal type:
    • Amount-Based - Save a specific amount
    • Date-Based - Save by a target date
  5. Enter goal title and target amount/date
  6. Tap Save

The app tracks your progress toward each goal, showing current amount saved, remaining amount or days, and progress percentage.

Settling Debts

In Shared Homes, go to Finance β†’ Bills tab and use the filter to view "Balances" to see who owes whom. Tap "Settle Up" to record payments and clear debts.

Free Tier Limits

  • Bills: Up to 10 bills
  • Expenses: Up to 50 expenses per month
  • Budget & Savings: Unlimited (all users)

Library Tab

The Library tab contains two sub-tabs: Lists and Documents. Swipe between them or tap the tab name at the top.

Lists

Create shopping lists, to-dos, and custom lists.

Creating a List

  1. Go to Library tab β†’ Lists sub-tab
  2. Tap the + button
  3. Enter list name
  4. Choose type (Shopping, Groceries, To-Do, Custom)
  5. Pick icon & color
  6. Toggle "Share with Home" for shared lists (Premium)
  7. Tap Save

Adding Items

Open any list, enter item text in the quick add field at the top, and tap + or press Enter. You can add quantity (e.g., "2x Milk") and the app will parse it automatically.

Completing Items

Tap the checkbox next to an item to mark it complete. Completed items move to the bottom automatically. Tap again to uncomplete an item.

Managing Lists

Long press on a list card to edit or delete. Only the list creator or shared home owner can delete a list.

πŸ’‘ Tip:

Free users can create up to 3 personal lists. Shared lists are unlimited for all users. Upgrade to Premium for unlimited personal lists!

Documents

Track expiry dates for important documents.

Adding a Document

  1. Go to Library tab β†’ Documents sub-tab
  2. Tap the + button
  3. Enter document title (e.g., "Driver's License")
  4. Choose type (Identity, Passport, Warranty, Contract, etc.)
  5. Set expiry date
  6. Add optional notes
  7. Mark as "Shared" if using Shared Home (Premium)
  8. Tap Save

Document Notifications

You'll receive notifications before documents expire (configurable days), when they expire today, and when they have expired.

Privacy Note: For security, the app does NOT store document images. It only tracks expiry dates and sends reminders.

Free Tier Limits

Free users can add up to 10 documents. Premium users have unlimited documents.

Shared Home (Premium)

Collaborate with family members or roommates on household management.

Inviting Members

  1. Go to Profile β†’ Shared Home
  2. Tap "Create Home" (if you haven't already)
  3. Find your unique Invite Code
  4. Share the code with household members
  5. They can join using "Join Home" option

Shared Features

  • Shared Bills & Expenses: Automatic expense splitting with debt calculation
  • Debt Calculator: See who owes what instantly with automatic calculations
  • Shared Routines: Everyone can complete and track routines together
  • Shared Lists: Real-time synchronization - see changes instantly
  • Shared Documents: Track household documents with shared expiry reminders
  • Activity Feed: See what everyone is doing in your shared home
  • Shared Budget: Track shared expenses against a household budget

Premium Features & Free Trial

All new users receive a 7-day free trial of Premium features. The app itself is free forever with generous free tier limits.

Premium Features

  • Shared Home: Create and join shared homes with unlimited members
  • Unlimited Items: No limits on routines, bills, expenses, documents, or personal lists
  • Preset Routine Library: Browse and add from 60+ preset routines tailored to household needs
  • Advanced Statistics: Historical data, charts, and data export
  • Shared Lists: Create unlimited shared lists with real-time collaboration

Free Tier Limits

Free users can enjoy:

  • Routines: Up to 5 active routines
  • Bills: Up to 10 bills
  • Expenses: Up to 50 expenses per month
  • Documents: Up to 10 documents
  • Personal Lists: Up to 3 personal lists
  • Budget & Savings: Unlimited (all users)

Note: Shared lists are unlimited for all users to encourage collaboration!

Trial Status

Your trial status is shown on your Profile card. You'll see a banner on your dashboard when your trial expires in 3 days or less.

Upgrading to Premium

  1. Navigate to Profile tab
  2. Tap "Upgrade to Premium" or find it in your profile settings
  3. Choose subscription:
    • Monthly - Monthly subscription
    • Annual - Annual subscription (save money)
  4. Complete purchase through App Store / Google Play
  5. Your subscription activates immediately

Restoring Purchases

If you've purchased Premium on another device, go to Profile β†’ Upgrade to Premium and tap "Restore Purchases" to sync your subscription.

Notifications & Reminders

Kavanoz sends helpful notifications to keep you on track. You can customize notification preferences in Profile β†’ Settings β†’ Notifications.

Notification Types

  • Routine Reminders: Daily, weekly, or monthly reminders at your set times
  • Streak Milestones: Celebrate at 7, 30, and 100 days
  • Streak Recovery: Get notified if you miss a day to help maintain your streak
  • Bill Reminders: Before bills are due, when due today, and when overdue
  • Budget Alerts: At 80%, 100%, and 120% of your budget
  • Document Expiry: Warnings before documents expire and when they expire
  • Shared Home Activities: When members add items, complete routines, or make changes
  • List Updates: When items are added or completed in shared lists

Notification Deep Linking

When you tap a notification, the app opens directly to the relevant screen:

  • Routine notifications β†’ Opens Routines tab
  • Bill notifications β†’ Opens Finance tab with Bills view
  • Document notifications β†’ Opens Library tab with Documents view
  • Budget notifications β†’ Opens Finance tab with Budget view
  • List notifications β†’ Opens Library tab with Lists view

Configuring Notifications

Go to Profile β†’ Settings β†’ Notifications to enable or disable specific notification categories. You can also use "Enable All" or "Disable All" for quick changes.

πŸ’‘ Tip:

Make sure notifications are enabled for Kavanoz in your device settings. On iOS: Settings β†’ Notifications β†’ Kavanoz. On Android: Settings β†’ Apps β†’ Kavanoz β†’ Notifications.

Troubleshooting

Common issues and solutions to help you get the most out of Kavanoz.

Account Issues

"Email not verified"

  • Check your inbox for the verification email
  • Tap "Resend" if you didn't receive it
  • Check your spam/junk folder
  • Make sure you entered the correct email address

"Forgot password"

  • Tap "Forgot Password?" on the sign-in screen
  • Enter your email address
  • Check your inbox for the reset link
  • If you don't receive it, check spam folder or try again

Notification Issues

"Notifications not working"

  • Go to Profile β†’ Settings β†’ Notifications and ensure notifications are enabled
  • Check device notification settings:
    • iOS: Settings β†’ Notifications β†’ Kavanoz
    • Android: Settings β†’ Apps β†’ Kavanoz β†’ Notifications
  • Ensure the app has notification permissions
  • Make sure your device is not in Do Not Disturb mode
  • Try restarting the app

Shared Home Issues

"Invite code not working"

  • Ensure the code is entered correctly (8 characters)
  • Check if the code has expired (ask the home owner to regenerate)
  • Make sure you have an active Premium subscription or trial
  • Verify you're not already in a shared home

"Can't add shared items"

  • Ensure you have an active Premium subscription or trial
  • Check if you're part of a shared home
  • Try signing out and back in
  • Check your internet connection

Currency & Savings Issues

"Currency conversion not working"

  • Check your internet connection
  • Set manual exchange rates in Profile β†’ Settings if needed
  • Gold/silver prices require MetalpriceAPI key (contact support if needed)
  • Try refreshing the savings screen

Sync Issues

"Changes not syncing"

  • Check your internet connection
  • Try pulling down to refresh the screen
  • Sign out and sign back in
  • Restart the app

Hitting Free Tier Limits

"Can't add more items"

  • You've reached a free tier limit
  • Upgrade to Premium for unlimited items, or
  • Delete unused items to free up space
  • For routines: Archive completed routines (they don't count toward the limit)

Getting Help

  • Contact Support: Email support@kavanoz.app
  • Visit Website: Check kavanoz.app for updates and support
  • Report Issues: Use the contact form on the website

Tips & Best Practices

Get the most out of Kavanoz with these helpful tips:

  • Set Up Routines Early: Create your most important routines first to start building streaks
  • Use Reminders: Set reminder times that work for your schedule to stay consistent
  • Track Everything: Add all bills and expenses for accurate budget tracking
  • Review Weekly: Check your weekly summary to stay on track with your goals
  • Set Savings Goals: Create specific, achievable savings goals to stay motivated
  • Use Shared Home: Collaborate with family/roommates for better organization and expense splitting
  • Enable Notifications: Stay on top of bills, routines, and important dates
  • Archive Completed Routines: Keep your active routines list clean (archived routines don't count toward free tier limits)
  • Use Preset Routines: Premium users can save time by browsing the preset routine library
  • Regular Updates: Keep the app updated for the latest features and bug fixes
  • Sync Across Devices: Your data syncs automatically across all your devices
  • Explore Features: Take the interactive tour from Settings to discover all features