Skip to content

Latest commit

 

History

History
147 lines (101 loc) · 4 KB

README.md

File metadata and controls

147 lines (101 loc) · 4 KB
Raw

Bike App


Cyclouse

Cyclouse is a modern iOS e-commerce application for bicycles and accessories, built with Swift and leveraging the latest frameworks and technologies 🚲

📹 Demo Video

Profile Home Map Payment
Profile Home Map Payment

📋Table of Contents

How to Clone and Run the Project

  1. Clone the repository: Open a terminal window and type the following command to clone the repository to your local machine:

    git clone https://github.com/faaarce/Cyclouse.git

  2. Install dependencies using Swift Package Manager: Navigate to the project directory:

    cd Cyclouse

    Once in the project directory, run the following command to resolve and fetch the project dependencies:

    swift package resolve

✨Features

📱 Interactive UI Components

  • Custom Animated Tab Bar: Engaging navigation with smooth animations
  • Nested Collection Views: Efficient browsing of categories and products
  • Hero Transitions: Seamless transitions between screens
  • ReactiveCollectionsKit Integration: Dynamic collection view updates
  • Plus Jakarta Sans Typography: Modern and clean font for better readability

💾 Robust Data Management

  • SwiftData for local persistence

📍 Location Services

  • Real-time GPS tracking with CoreLocation
  • MapKit integration with 3D views
  • Custom map annotations

🔔 Smart Notifications

  • SwiftMessages for custom alerts
  • EasyNotificationBadge for cart updates
  • JDStatusBarNotification integration
  • Interactive toast messages
  • Status bar notifications

⚡️ Enhanced User Experience

  • SkeletonView for loading states
  • Hero animations for transitions
  • IQKeyboardManager integration
  • Lottie animations
  • NVActivityIndicatorView for loading button

🏗 Technical Architecture

  • MVVM-C pattern with Coordinator
  • Dependency injection using Swinject
  • Reactive programming with Combine
  • Protocol-oriented design

💻 System Requirements

  • iOS 15.0 or later
  • Xcode 14.0 or later
  • Swift 5.5 or later
  • CocoaPods 1.11.0 or later

🏗 Architecture

Cyclouse uses MVVM-C pattern with:

  • Model: Data structures and business logic
  • View: UI components and layouts
  • ViewModel: Business logic
  • Coordinator: Navigation and flow management

Tech Stack 🛠

Programming Languages & Frameworks

  • Swift
  • UIKit

Core Technologies

  • SwiftData
  • MapKit & CoreLocation
  • Combine & CombineCocoa
  • SnapKit for layouts
  • PhoneNumberKit

UI/UX

  • Hero Transitions
  • SwiftMessages
  • Lottie Animations
  • IQKeyboardManager
  • Plus Jakarta Sans typography
  • ReactiveCollectionsKit

Data & Security

  • Valet for securely stores sensitive data in the keychain
  • Firebase services
  • SwiftData persistence

Networking

  • Alamofire with Combine

Swift UIKit

License

This project is currently unlicensed. All rights reserved.