TrekStar - Your Ultimate Backpacking Companion
TrekStar helps you stay organized and prepared for all your backpacking adventures. Whether you’re packing for a short hike or a multi-day trek, this iOS app simplifies the process of tracking your gear, managing packing lists, and managing item weights – now with support for switching between kilograms and pounds!
Features
• Organized Inventory: Sort your gear into categories like Clothing, Shelter, Electronics, First Aid, and more. Track item names, quantities, and weights.
• Custom Packing Lists: Create personalized packing lists for different trips using items from your inventory. Automatically calculate the total weight of your gear.
• Weight Unit Conversion: Switch easily between pounds and kilograms to track your gear’s weight in your preferred unit.
• Edit and Update Gear: Easily edit existing gear items or lists to reflect your current needs.
• Add New Gear: Quickly add new items to your inventory, specifying details like weight, category, and quantity.
• Seamless List Management: Add or remove gear from lists directly from your inventory.
Tech Stack
• Swift: Main programming language for iOS app development.
• SwiftUI: Used for building the user interface with declarative syntax.
• Xcode: Integrated Development Environment (IDE) for iOS app development.
Installation
To get started with TrekStar, follow these steps:
-
Clone the repository
git clone https://github.com/kabdelhalem/TrekStarIOS.git -
Open the Project in XCode
cd TrekStar
open TrekStar.xcodeproj
- Build and run the app: Make sure your development environment is set up with Xcode and the latest iOS SDK. Choose a target device or simulator and run the app using the play button in Xcode.
Requirements
• iOS 14.0+
• Xcode 12.0+
• Swift 5.0 or later
Usage
Once the app is installed:
• Create an Inventory: Add your gear with item names, weight, and category.
• Build Packing Lists: Select items from your inventory to create custom packing lists for different trips.
• Track Weight: View the total weight of your gear and switch between kilograms and pounds.
• Edit as You Go: Adjust your gear and lists as needed.
Contributing
Contributions are welcome! If you’d like to contribute to TrekStar, feel free to:
1. Fork this repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add a feature').
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contact
Feel free to create an issue in this repository for any questions or feedback.