CarbSmart - Release Notes

Version 1.2.1 - Current Release

Release Date: 2025

Overview

CarbSmart is a smart meal planning application specifically designed for diabetes management. This desktop application helps users track carbohydrate intake with precision using standardized 30g portion guides and build balanced meals with accurate nutritional data.

🎯 Key Features

Core Functionality

• Comprehensive Food Database

  • 500+ food items across 30+ categories
  • Each item standardized to 30g carbohydrate portions (2 carb choices)
  • Includes both high-carb and low-carb food options
  • Detailed portion size information for accurate tracking

• Intelligent Meal Planning

  • Interactive meal builder with real-time carbohydrate tracking
  • Add/remove items with simple checkbox selection
  • Adjustable portion quantities with increment/decrement controls
  • Visual calculation display showing portion math
  • Total carbohydrate summary in both grams and carb choices

• Smart Search & Filtering

  • Real-time search across food names and portions
  • Category-based filtering (30+ food categories)
  • Dynamic status updates showing filtered results
  • User-friendly organization of food items

Food Categories

The application includes extensive coverage across:

• Breads & Grains - Breads, bagels, rolls, tortillas, and more
• Rice & Pasta - All varieties including international options
• Breakfast Cereals - Hot and cold cereals, granola, oats
• Breakfast Items - Pancakes, waffles, muffins, and pastries
• Starchy Vegetables - Potatoes, corn, peas, squash, and root vegetables
• Beans & Legumes - All bean varieties, lentils, hummus
• Fruits - Fresh fruits, dried fruits, and fruit juices
• Dairy - Milk, yogurt, ice cream, and frozen desserts
• Snacks & Crackers - Chips, pretzels, popcorn, bars
• Sweets & Desserts - Cookies, cakes, pies, candy, and treats
• Fast Food - Common fast food items
• Pizza - Various crust types and styles
• Sandwiches & Wraps - Bread-based meals
• Mexican & Latin Foods - Tacos, burritos, tamales
• Asian Foods - Rice dishes, noodles, sushi, dumplings
• Soups - Various soup types
• Condiments & Sauces - High-carb sauces and sweeteners
• Low-Carb Proteins - Meats, poultry, seafood, eggs (0-5g carbs)
• Low-Carb Dairy - Cheese, cream, full-fat dairy
• Low-Carb Vegetables - Non-starchy vegetables (2-7g carbs)
• Nuts & Seeds - Portion-controlled nut servings
• Fats & Oils - Zero-carb cooking fats

User Interface

• Modern, Clean Design

  • Material Design-inspired color scheme
  • Optimized window size (900x700 pixels) for comfortable viewing
  • Intuitive two-panel layout (food list + meal summary)
  • Responsive controls with visual feedback
  • Professional gradient header with branding
  • Accessible typography and spacing

• Visual Elements

  • Color-coded category badges
  • Alternating row colors for easy scanning
  • Highlighted totals and calculations
  • Shadow effects for depth and hierarchy
  • Emoji icons for quick visual recognition

• Interactive Controls

  • Smooth hover states on buttons
  • Focused input borders for accessibility
  • Quantity adjustment buttons with instant feedback
  • One-click item removal from meal
  • Clear meal function with confirmation

Technical Specifications

• Platform: Windows Desktop Application
• Framework: .NET 10 with WPF
• Architecture: MVVM (Model-View-ViewModel) pattern
• Data Binding: Reactive UI with INotifyPropertyChanged
• Language Features: C# 13 with nullable reference types
• UI Technology: XAML with custom styles and templates

Help & Information

• About Window - Application information and credits
• License Window - Full license text viewer
• Menu System - Organized help menu for easy access
• Status Bar - Real-time feedback on meal composition

📋 System Requirements

Minimum Requirements

• Operating System: Windows 10 (version 1809 or later) / Windows 11
• Framework: .NET 10 Runtime (included with installation package)
• RAM: 4 GB
• Storage: 100 MB available space (includes runtime installers)
• Display: 1024x768 resolution or higher
• Architecture: x86, x64, or ARM64

Recommended Requirements

• Operating System: Windows 11
• RAM: 8 GB or more
• Display: 1920x1080 resolution or higher
• Architecture: x64

🚀 Getting Started

Installation

Option 1: Automatic Installation (Recommended)

1. Download the CarbSmart installation package
2. Run the setup executable
3. The installer will automatically detect if .NET 10 Runtime is required
4. Follow the installation wizard prompts
5. Launch CarbSmart from Start Menu or Desktop shortcut

Option 2: Manual .NET Runtime Installation

If you prefer to install the .NET 10 Runtime separately:

1. Determine Your Windows Architecture:

• Open Settings → System → About
• Check "System type" (32-bit, 64-bit, or ARM64)

2. Install the Appropriate .NET 10 Runtime: The installation package includes three runtime installers in the Assets\installers folder:

• For 64-bit Windows (x64): runtime-aspnetcore-10.0.1-windows-x64-installer.exe
• For 32-bit Windows (x86): runtime-aspnetcore-10.0.1-windows-x86-installer.exe
• For ARM64 Windows: runtime-aspnetcore-10.0.1-windows-arm64-installer.exe

3. Run the CarbSmart Application:

• After runtime installation, launch CarbSmart.exe

Verifying .NET Installation

To check if .NET 10 Runtime is already installed:

1. Open Command Prompt or PowerShell
2. Type: dotnet --list-runtimes
3. Look for "Microsoft.NETCore.App 10.0.x" in the output

Package Contents

The CarbSmart distribution includes:

• CarbSmart application executable and dependencies
• .NET 10.0.1 ASP.NET Core Runtime installers (all architectures)
• Application assets (icons, images)
• License documentation
• This README file

Total Package Size: Approximately 100 MB (including all runtime installers)

First Use

1. Browse the food database using search or category filters
2. Check items to add them to your meal plan
3. Adjust quantities using +/- buttons
4. Monitor total carbohydrates in the right panel
5. Clear meal and start fresh as needed

💡 Usage Tips

Accurate Tracking

• Each food item represents a standardized 30g carbohydrate portion
• Use the quantity controls to match your actual portion sizes
• Check the portion descriptions for accurate measurements
• Total carbs are calculated automatically (carbs per portion × quantity)

Meal Planning

• Build balanced meals by selecting items from different categories
• Use the "carb choices" display to manage diabetes meal planning (1 choice = 15g)
• Low-carb items (0-7g) help round out meals without adding significant carbs
• Mix and match to meet your target carbohydrate goals

Efficient Searching

• Type any part of a food name to filter instantly
• Use category filter to focus on specific food types
• Combine search and category filters for precise results
• Status bar shows how many items match your filters

📝 Known Limitations

Current Version

• Food database is pre-populated (custom foods not supported in v1.0)
• Meal plans are not saved between sessions
• No nutritional tracking beyond carbohydrates
• Single meal view (cannot plan multiple meals simultaneously)
• No export or print functionality

Planned Features (Future Releases)

• Save and load meal plans
• Custom food entry
• Multiple meal planning (breakfast, lunch, dinner)
• Nutritional information beyond carbs (protein, fat, fiber, calories)
• Meal history and favorites
• Export to PDF or print
• Cloud sync capabilities
• Mobile companion app

🔧 Technical Notes

Architecture Highlights

• MVVM Pattern - Clean separation of concerns
• Observable Collections - Automatic UI updates
• Command Pattern - Action handling via ICommand
• Event-Driven - PropertyChanged notifications for reactivity
• Repository Pattern - Centralized food data management

Code Quality

• Nullable reference types enabled for null safety
• Implicit usings for cleaner code
• Modern C# features and patterns
• WPF best practices for UI responsiveness
• Efficient data binding with minimal code-behind

Bundled Runtime Information

• Runtime Version: .NET 10.0.1 ASP.NET Core Runtime
• Included Architectures: x86 (32-bit), x64 (64-bit), ARM64
• Runtime Size: ~340 KB per architecture
• Installation: Automatic detection or manual selection

Application Specifications

• Window Dimensions: 900 pixels (width) × 700 pixels (height)
• Minimum Screen Resolution: 1024x768
• Optimal Resolution: 1920x1080 or higher
• DPI Aware: Yes, supports high-DPI displays

🏷️ Branding

Product Name: CarbSmart
Tagline: Smart Diabetes Meal Planning
Developer: Rochaus Design™
Copyright: © 2025 Rochaus Design. All Rights Reserved.
License: Proprietary (See LICENSE.txt for details)

📞 Support & Feedback

Getting Help

• Access built-in help via the Help > About CarbSmart menu
• View license information via Help > View License
• Refer to this document for feature explanations

Contact Information

For questions, feedback, or support inquiries, please contact:

• Company: Rochaus Design
• Product: CarbSmart - Diabetes Meal Planner

📜 Version History

Version 1.2.1 (Current Release)

• Optimized window dimensions (900x700 pixels)
• Bundled .NET 10.0.1 ASP.NET Core Runtime installers (x86, x64, ARM64)
• Enhanced installation package with runtime support
• Improved system requirements documentation
• Updated distribution package (~100 MB total size)

Version 1.0.0 (Initial Release)

• First public release
• Core meal planning functionality
• 500+ food items across 30+ categories
• Modern WPF user interface
• Real-time carbohydrate tracking
• Search and filter capabilities
• MVVM architecture
• .NET 10 compatibility

⚖️ Legal

Copyright Notice

CarbSmart - Diabetes Meal Planner
Copyright © 2025 Rochaus Design
All Rights Reserved

Trademark

Rochaus Design™ is a trademark of Rochaus Design

Medical Disclaimer

Important: This application is designed as a meal planning tool and should not replace professional medical advice. Always consult with your healthcare provider or certified diabetes educator regarding your specific dietary needs and diabetes management plan. Nutritional information is provided for general reference purposes.

Accuracy Notice

While every effort has been made to ensure the accuracy of nutritional information, portion sizes and carbohydrate values may vary based on preparation methods, brands, and serving sizes. Always verify nutritional information when precise tracking is critical.

🎉 Acknowledgments

Development

• Built with .NET 10 and Windows Presentation Foundation (WPF)
• Developed by Rochaus Design

Icons & Assets

• Application icon included in release package
• Custom branding and logo design

Thank you for choosing CarbSmart for your diabetes meal planning needs!

For the latest updates and information, please check for new versions periodically.