Skip to content

My Treasure Chest

shriansh edited this page Oct 24, 2025 · 2 revisions

Welcome to the My Treasure Chest Wiki! 👑

My Treasure Chest is a fun, simple, and powerful allowance tracker designed just for kids! It helps you learn about money by tracking every penny you earn, save, and spend. Watch your treasure grow and save up for your dreams!

Built with SwiftData and iCloud Sync, your treasure is always up-to-date and available across all your Apple devices.

✨ Core Features

  • Track Your Money: Easily add money (deposits) and track your spending (withdrawals).
  • See Your Balance: The main dashboard always shows your Current Balance in big, bold numbers.
  • Live Previews: When adding or spending, the app shows you what your new balance will be before you save.
  • Overdraft Protection: The app won't let you spend more money than you have, helping you learn smart spending habits.
  • iCloud Sync: Your data is automatically and securely synced across all your devices using your iCloud account.
  • Currency Customization: Choose your local currency! The app supports over 15 currencies (like $, £, €, ¥, ₹, and more).
  • Full Transaction History: See a list of all your recent activity. Tap any transaction to see the full details, including the date and time.
  • Personalization: Add your name to make the app your own!
  • Fun & Safe:
    • Get a new kid-friendly joke every time you open the app!
    • "Danger Zone" in settings with a triple-confirmation alert to prevent accidentally deleting all your data.

📱 App Screens & Flow

1. Main Dashboard (ContentView)

This is your home base! From here you can:

  • See your total balance.
  • See a welcome message with your name.
  • Quickly access the Add Money and Spend Money screens.
  • Access Settings, Name Setup, and the Joke of the Day.
  • Scroll through your Recent Activity list.
  • Swipe-to-delete any transaction right from the list.

2. Adding & Spending (AddMoneyView & WithdrawMoneyView)

These simple sheets make tracking easy:

  • Adding Money (💰): Enter an amount and a description (e.g., "Weekly Allowance," "Birthday Gift"). The app shows you Current + Amount = New Balance.
  • Spending Money (💸): Enter an amount and a description (e.g., "Ice Cream," "New Toy"). The app shows you Current - Amount = New Balance. It will disable the button if you try to spend more than you have!

3. Transaction Details (TransactionDetailView)

Tap on any transaction in your history to see all the details:

  • The transaction type ("Money In" or "Money Out") with its emoji.
  • The exact amount.
  • The full description.
  • The precise date and time it was logged.
  • A button to delete that specific transaction.

4. Settings (SettingsView)

Customize the app to work for you:

  • Currency: Tap to open a list and select your local currency. This will update the symbol ($) across the entire app.
  • View Onboarding: See the welcome-screen instructions again.
  • Delete All Transactions: A "Danger Zone" option that is heavily protected. You must confirm three times before the app will delete your history, making it safe from accidental taps.

5. Setup (NameSetupView & OnboardingView)

  • Onboarding: The very first time you launch the app, you'll see a fun welcome screen explaining what to do.
  • Name Setup: After onboarding, you'll be asked for your name. This can be changed anytime from the main dashboard.

🛠️ Technology

  • SwiftUI: The entire app is built using Apple's modern UI framework.
  • SwiftData: All transactions and user settings are stored locally using SwiftData.
  • CloudKit: SwiftData is configured with .cloudKitDatabase(.automatic) to seamlessly and privately sync all data to the user's personal iCloud account.

⛑️ Get Support

Need help, have feedback, or found a bug? We're here for you!

For any questions or support issues, please send an email to our team at: mytreasurechest-support@shriansh.com