A beautiful and intuitive iOS countdown app built with SwiftUI that helps you track important events and milestones in your life.
TimesMatter is a modern iOS application designed to help users create and manage countdown timers for important events. Whether it's a birthday, vacation, project deadline, or any significant milestone, TimesMatter provides a clean and elegant way to keep track of time.
- Countdown Management: Create and manage multiple countdown timers
- Categories: Organize countdowns with custom categories
- Customization: Personalize countdowns with custom icons, colors, and titles
- Favorites: Mark important countdowns as favorites for quick access
- Archive: Archive completed or old countdowns
- Modern UI: Built with SwiftUI for a native iOS experience
- Data Persistence: Uses SharingGRDB for reliable data storage
- Framework: SwiftUI
- Language: Swift
- Database: SharingGRDB
- Minimum iOS Version: iOS 17.0+
- Target iOS Version: iOS 18.0+ (with backward compatibility)
- Xcode 16.2+
- iOS 17.0+
- macOS 14.0+ (for development)
- Make sure you have Xcode 16.2 or later installed
- Ensure you have a valid Apple Developer account (for device testing)
-
Clone the repository
git clone https://github.com/yourusername/times-matter.git cd times-matter -
Open the project in Xcode
open TimesMatter.xcodeproj
-
Select your target device or simulator
-
Build and run the project (⌘ + R)
TimesMatter/
├── App/
│ └── TimesMatterApp.swift # Main app entry point
├── Components/
│ ├── Countdown/
│ │ └── CountdownList.swift # Countdown list view
│ └── Me/
│ └── Me.swift # User profile view
├── Model/
│ ├── Countdown.swift # Countdown data model
│ └── Category.swift # Category data model
├── Service/
│ ├── CountdownStore.swift # Countdown data management
│ └── CategoryStore.swift # Category data management
├── Utilies/
│ ├── Extension/
│ │ └── Color+Extensions.swift # Color utilities
│ ├── HashableObject.swift # Hashable object utilities
│ └── Schema.swift # Database schema
└── Assets.xcassets/ # App assets and icons
- Create new countdown timers with custom titles
- Set custom icons and colors for visual distinction
- Mark countdowns as favorites for quick access
- Archive completed countdowns
- Organize countdowns into custom categories
- Easy filtering and organization
- Modern SwiftUI interface
- Tab-based navigation
- Responsive design for different iOS versions
- Native iOS design patterns
The app follows a clean architecture pattern with:
- Models: Data structures for Countdown and Category
- Views: SwiftUI views for the user interface
- Services: Data management and business logic
- Utilities: Helper functions and extensions
The app uses SharingGRDB for data persistence, providing:
- Reliable data storage
- Type-safe database operations
- Efficient querying capabilities
We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow Swift style guidelines
- Use meaningful variable and function names
- Add comments for complex logic
- Ensure code is properly formatted
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with SwiftUI and SharingGRDB
- Icons and assets designed for iOS
- Thanks to the SwiftUI and iOS development community
If you have any questions or need support, please:
- Check the existing issues
- Create a new issue with a detailed description
- Contact the development team
If you love beautiful, productive apps, please star this project on GitHub and help us grow!
You can also experience TimesMatter on your iPhone or iPad:
Made with ❤️ for iOS users who value their time.