v0.6.1.-alpha; Donation Date Tracking

v0.6.1-alpha Pre-release

The Donation Timestamp Update
Released: December 18, 2024 2:05 AM

Major Features

Donation Timestamp System

• Added timestamp tracking for all museum donations
• Built DetailMoreInfoView to display donation info and (soon) much more
• Smooth SwiftData integration for persistent tracking
• Works great across iOS, iPadOS, and macOS

DetailMoreInfoView Updates

• New expandable info panel in item details
• Currently shows donation timestamps
• Built to be expandable - will be adding way more item info soon
• Clean, simple interface that works well on all devices
  

Backend & Technical

• Enhanced SwiftData models for timestamp support
• Better organized data model structure
• Improved donation toggles and state management
• Added debug logging because why not

UI Improvements

• New "More info" button when you click on an item. Currently shows the date, but will house all the new item info I mentioned earlier in the coming updates.

Technical Stuff

• New timestamp protocol and extensions
• Updated core models to support timestamps
• DetailMoreInfoView component for future expansion
• Organized everything better for easier updates
• Works perfectly across all Apple platforms (seriously, tested extensively)

Known Issues

• Search still only works in current category (just haven't gotten around to it)

Coming Soon

• The DetailMoreInfoView is going to become a central hub for all item information. I'm planning to include:
  • Which games each item appears in (since we now track multiple AC games)
  • For fish: Everything you need to know - seasons, time of day, shadow size
  • For fossils: Whether it's standalone or part of a larger set, and thinking about adding some cool trivia like what prehistoric era it's from
  • For art: Authentication tips and details
• Adding the ability to set custom donation dates - this way if you're coming from another tracking method or just logging based off of when you previously donated something, you can save it properly
• Python version dropping this week - I'm making this half for fun and half for practice, but there's actually a practical reason too: Swift apps are a pain to self-install, so this will let people actually test it out. Thinking about sharing it on Reddit to get some early feedback before the App Store release.
• More improvements as I think of them - I'm always open to suggestions!

Development Notes

• Xcode 15+ required
• iOS/iPadOS 17.0+ or macOS 14.0+
• Uses SwiftData & SwiftUI
• Complete feature parity across platforms

Installation

1. Clone the repo
2. Open in Xcode 15+
3. Build and run on any supported platform

What's Changed

• Feat/timestamps by @jacuzzicoding in #28

Full Changelog: v0.6.0-alpha...v0.6.1-alpha

v0.6.0-alpha

The Town and Games Update

Released: December 16, 2024 2:05 AM

Major Features

Town System Implementation

• Added new Town feature allowing players to name their town
• Implemented SwiftData integration for town persistence
• Cross-platform town editing interface for both iOS and macOS

Multi-Game Support Framework

• Implemented ACGame enum system for game version tracking
• Added foundational multi-game support structure
• Prepared database schema for cross-game item tracking
• Updated all item models with game version support
• Reformatted data structures for better maintainability
• Added ACGCN tags to all existing items (fossils, bugs, fish, and art)

Backend Improvements

• New DataManager system for centralized data handling (mostly for the town struct for now)
• Enhanced SwiftData integration with proper error handling
• Improved cross-platform compatibility
• Optimized data fetching and persistence

UI/UX Enhancements

• Platform-specific town editing interfaces
• Custom macOS window sizing and controls
• Improved form handling and data validation

Technical Details

New Components

• Town.swift: Core town data model with SwiftData integration
• DataManager.swift: Centralized data management system
• EditTownView.swift: Cross-platform town editing interface
• Games.swift: Game enumeration and configuration system

Architecture Changes

• Implemented ObservableObject pattern for UI state management
• Added proper main thread handling for UI updates
• Enhanced error handling for database operations
• Improved model container initialization
• Restructured data models to support game versioning
• Enhanced fish collection with game-specific data
• Prepared for expansion from 40 to 80 fish entries
• Added support for multiple Animal Crossing titles:
  • Animal Crossing GameCube (ACGCN)
  • Wild World (ACWW)
  • City Folk (ACCF)
  • New Leaf (ACNL)
  • New Horizons (ACNH)

Cross-Platform Support

• Platform-specific UI implementations using #if os(macOS)
• Consistent behavior across iOS and macOS
• Optimized layouts for different screen sizes
• Modern navigation APIs for iOS

Known Issues

• Search still limited to current category
• No transition animations for category switches

Future Plans

• Complete New Horizons fish data integration
• Expand fish collection to 80 entries
• Add sea creatures category
• Implement game-specific filtering system
• Consider project rebranding to reflect broader scope
• Expanded town customization options
• Multi-town support preparation
• Enhanced data migration system
• Additional platform-specific optimizations
• Villager management system (up to 15) with birthday tracking
• Calendar system with game-specific holiday tracking
• Special event tracking (fishing tourneys, etc.) based on selected game
• Donation date tracking with visual progress graphs
• Haptic feedback support for iOS
• Potential Python port for expanded desktop user base

Development Notes

• Built with Xcode 15+
• Requires iOS 17.0 or macOS 14.0 and above
• Uses SwiftData for persistence
• Implements SwiftUI for all user interfaces

Installation

1. Clone the repository
2. Open in Xcode 15 or later
3. Build and run on iOS 17.0+ or macOS 14.0+

Feedback and Contributions

• Report issues on GitHub
• Pull requests welcome

Screenshots:

iOS

---

Released by Brock Jenkinson (@jacuzzicoding)
December 16, 2024

What's Changed

• Feature/multi-game-support by @jacuzzicoding in #25
• merge main by @jacuzzicoding in #26
• Feature/towns by @jacuzzicoding in #27

Full Changelog: v0.5.1-alpha...v0.6.0-alpha

v0.5.1-alpha Mac OS Fix

Release Date: December 7, 2024, 3:51 AM EST

This update resolves the critical macOS category switching bug while implementing a more organized project structure. Stable across iOS, iPadOS, and macOS platforms.

---

TL;DR:

• Fixed macOS category switching bug (#17)
• Implemented new modular file organization
• Enhanced FloatingCategorySwitcher with improved state management
• Added macOS-specific UI improvements
• Better code organization and documentation

---

Technical Details:

• CategoryManager for state handling
• Enhanced hit testing and button interaction on macOS
• Reorganized project into clear directory structure (App/, Models/, Views/)
• Added Constants.swift for utility constants
• Improved navigation destination logic
• Optimized FloatingCategorySwitcher layout for both iOS and macOS

---

Screenshots:

iOS Museum Tracker

macOS Museum Tracker

---

Known Issues:

• Search still limited to the current category.

---

What's Changed

• Mac OS Fix (v0.5.1-alpha) by @jacuzzicoding in #24

Full Changelog: v0.5.0-alpha...v0.5.1-alpha

v0.5.0-alpha UI Update

Release Date: November 23, 2024 3:18 am

This update brings the first major UI overhaul while building on the code cleanup from v0.4.3-alpha. Stable on iOS/iPadOS, but has some known issues on macOS.

TLDR;

New floating category buttons instead of the top selector
Each category now has a unique icon
Main view defaults to fossils and can be switched. It is no longer a toggle on/off selection.
Enhanced search and navigation
Minor animation improvements
Foundation for future UI improvements

Technical Details:

Enhanced CollectibleItem protocol now conforms to Hashable
Added symbolName to category enum for icons
New FloatingCategorySwitcher and CollectibleRow structs
Updated CategorySection for better item presentation
Maintained existing SwiftData integration

Known Issues:

macOS breaks when switching categories (#17)
Search limited to current category
Needs additional macOS testing

What's Changed

• UI Update Alpha (Mac Issues) by @jacuzzicoding in #19

Full Changelog: v0.4.3-alpha...v0.5.0-alpha

What's Changed

• UI Update Alpha (Mac Issues) by @jacuzzicoding in #19

Full Changelog: v0.4.3-alpha...v0.5.0-alpha

v0.4.3-alpha Cleanup Update

v0.4.3-alpha
Release Date: November 19, 2024 12:53 AM EST

This update is mostly an under the hood code cleanup that took some time, but should hopefully make development smoother and faster. No changes on the user end, but lots of architectural improvements.
TLDR;

Major code reorganization and cleanup
Better organization of museum items (fossils, bugs, fish, art)
More consistent internal handling of features
Foundation for future improvements

Technical Details:

Introduced CollectibleItem protocol to standardize item handling
Replaced string-based categories with proper enum system
Created generic CategorySection view to reduce duplicate code
More centralized state management
Maintained existing SwiftData implementation and platform adaptations

358 additions
424 deletions

What's Changed

• Prepping Refractor2 for main by @jacuzzicoding in #15
• Merge pull request #15 from jacuzzicoding/main by @jacuzzicoding in #16

Full Changelog: v0.4.2a-alpha...v0.4.3-alpha

v0.4.2-alpha

Release Date: October 17, 2024

This update focuses on fixing navigation issues in the detail view on iPhones, enhancing the user experience across devices, and laying the groundwork for future art image display.

TLDR;
• Fixed iPhone Detail View: Resolved a UI issue causing the detail view to appear under the navigation bar.
• Improved Navigation: Replaced buttons with NavigationLink for smoother navigation and separated toggles from navigation to avoid conflicts.
• Art Updates: Added artist names for each art piece and introduced an imageName property for future image display.
• Foundation for Image Display: Set the groundwork for displaying art images in future updates.

Changelog:

Fixed Detail View Display Issue on iPhone:

•	Removed .background Modifier:
•	The .background modifier in the compact size class (iPhone) was causing the detail view to appear under the navigation bar. This has been removed, resolving the UI glitch on iPhone.

Improved Navigation:

•	Replaced Button with NavigationLink:
•	Updated list sections (fossils, bugs, fish, and art) to use NavigationLink for proper navigation to detail views.
•	This ensures a standard navigation experience when tapping on list items.
•	Separated Toggle Controls:
•	Moved toggles for marking items as donated outside of NavigationLink and placed them in an HStack, preventing conflicts between toggles and navigation.

Enhanced User Interaction:

•	Interactive Toggles:
•	Users can now mark items as donated directly from the list without accidentally triggering navigation, maintaining smooth interaction.
•	Consistent Design Across Devices:
•	Applied navigation and interaction changes across both iPhone and iPad/Mac, ensuring consistency in user experience across all device sizes.
•	App is generally just much smoother now.

Art Tracking Improvements:

•	Artist Names Added:
•	The basedOn field now includes the artist’s name alongside the title of each art piece (e.g., “Mona Lisa by Leonardo da Vinci”).
•	Image Property Added:
•	Introduced an imageName property for each art piece in the data model, setting the stage for future updates that will display artwork images.
•	Foundation for Image Display:
•	Updated the ArtDetailView to include an Image view (currently commented out until images are added), preparing for future updates where art images will be shown.

This update focuses on improving user interaction and navigation, with plans for displaying art images in future releases.

What's Changed

• v0.4.2-alpha by @jacuzzicoding in #13

Full Changelog: v0.4.1-alpha...v0.4.2a-alpha

v0.4.1-alpha

Release Date: October 11, 2024, 4:14 AM

TLDR;
•Added a category filter for toggling between fossils, bugs, fish, and art.
•Optimized code by switching from a list to a vertical stack, improving performance.
•Introduced a new detail view for iPhones, though it remains partially broken.

Original Text:

New Features and Improvements:

Category Filter: Added a new filter option allowing users to toggle between fossils, bugs, fish, and art. This feature helps streamline the navigation of the collectible categories, making it easier to track specific types of donations.
Code Optimization: Switched from using a list to a vertical stack for displaying collectibles. This optimization improves performance and maintains smoother navigation across different device sizes.
iPhone Detail View: Introduced a new detail view for iPhones, providing a dedicated display for viewing detailed information about selected collectibles.
Known Issues:

The iPhone detail view remains partially broken, with layout inconsistencies and rendering issues. Further adjustments are needed to ensure proper display and usability on iPhone devices.
This update enhances user experience by providing better navigation and performance while continuing to work toward more polished views on iPhones.

Full Changelog: GitHub Changelog Link

Here is a screenshot of the new category filter in action:

Full Changelog: v1.10.11.24.a...v1.10.11.24.b

v0.4.0-alpha - Pi Time Update

Release Notes for v0.4.0-apha - October 11, 2024 3:14 AM

New Features:

•	Finally: Art Tracking Functionality!
•	Added a new section dedicated to tracking the paintings in the museum.
•	Players can now mark art donations and view the real names for famous paintings such as the Mona Lisa (Famous Painting) and Sunflowers (Flowery Painting), including their real-world counterparts.
•	The art section completes the app’s collectible tracking, covering fossils, bugs, fish, and now art.

What's Changed

• V1.10.11.24.a by @jacuzzicoding in #8

Full Changelog: v1.10.07.24...v1.10.11.24.a

v0.3.1-alpha

Release Notes for v0.3.1-alpha

• October 7, 2024 12:27 AM

New Features:

•	Search Functionality:
•	A search bar has been added to the main view, allowing users to quickly find fossils, bugs, and fish by name.
•	This feature streamlines navigation through large collections, making it easier to track down specific museum donations by name. 

Improvements:

•	Bug Season Display Fix:
•	Fixed an issue where the season information for bugs was displayed with unnecessary “Optional(…)” text.
•	The season text now displays cleanly and correctly for all bugs in the tracker.

These updates enhance the usability of the app, providing a smoother experience for users managing their museum collectibles.

Pictures of the new search bar:

Full Changelog: v1.10.06.24...v1.10.07.24

v0.3.0-alpha

Release Date: October 6, 2024, 4:52 PM EST

This update introduces fish tracking! This release also includes minor UI improvements and bug fixes to improve overall performance and stability.

What’s New in v0.3.0-alpha:

Fish Tracking:

•	Added the ability to track fish donations in the museum collection.
•	You can now:
•	Mark fish as donated or not.
•	View detailed information such as fish name, season availability, and location (e.g., river, sea, pond).
•	A pre-populated list of 40 fish is provided on first launch.
•	Donation statuses for fish are saved between sessions.

UI Adjustments:

•	The main view now includes a new section for fish alongside fossils and bugs.
•	Fish detail views provide donation status, season availability, and location data.

Performance Improvements & Fixes:

•	Optimized how data is loaded and persisted, improving load times and memory management.
•	Minor code cleanup for smoother performance and reduced overhead.
•	Fixed an issue with UI scaling on certain iPhone screen sizes, ensuring better consistency across devices.

Known Limitations:

•	Delete Function: The delete function permanently removes the item you delete with no way to restore it. An add item function may be implemented, or the delete feature may be removed altogether.
•	DetailView Unavailable on iPhones: Currently, the detailed view is not available on iPhones. Future updates will include icons for each item and a fully fleshed-out detail view with pictures and descriptions.
•	Art tracking has not yet been added but is planned for a future release.
•	The app can only be run via Xcode for testing or development purposes.

How to Use:

1.	Clone or download the repository.
2.	Open the project in Xcode.
3.	Build and run the app using an iPhone, iPad, or macOS target in the Simulator or on a physical device.

Future Steps:

•	Art Collection:

A future update will introduce art tracking for the museum. This feature will allow users to track their donated art pieces, check authenticity, and see which artworks are available.
• Search and Filtering:
Enhanced usability features, including a search bar and filtering options, will allow users to sort their collections by season, donation status, or collectible type.
• User Experience Improvements:
Future updates will include progress bars for fossils, bugs, fish, and art, as well as a more polished user interface for better ease of use.
• Cross-Platform Support:
Continued improvements to NavigationStack and NavigationSplitView to ensure consistent behavior across iPhone, iPad, and macOS platforms.
• Data Export/Import:
A future feature will allow users to export and import their collection data for better flexibility when managing across devices or after an app reset.
• Date of Donation Tracking:
The next update will introduce a feature to track the date of donation via user input. This data will be used to generate charts and visualizations over time.
• Localization:
In later updates, support for multiple languages may be added to make the app more accessible to non-English speakers.

This is teaching me a lot about XCode, and I’m having a lot of fun building it! Feel free to check it out, use it, or contribute if you like!

What's Changed

• 1.10.06.24 by @jacuzzicoding in #4

Full Changelog: v1.10.05.24.b...v1.10.06.24

Full Changelog: v0.2.0-alpha...v0.3.0-alpha