Skip to content

kimhons/navi-app

Repository files navigation

Navi - Navigate Smarter ๐Ÿ—บ๏ธ

A professional navigation app with 62 screens per platform, built with modern architecture and beautiful design.

Version iOS Android Languages


โœจ Features

๐Ÿ—บ๏ธ Navigation

  • Turn-by-turn navigation with voice guidance
  • Real-time traffic updates and incident alerts
  • Multiple route options with ETA comparison
  • Lane guidance for complex intersections
  • Speed limit display and warnings
  • Offline maps for navigation without internet
  • Multi-stop routes for efficient trip planning

๐Ÿ” Search & Discovery

  • Advanced search with filters and categories
  • Place details with photos, reviews, and ratings
  • Nearby places discovery
  • Popular destinations recommendations
  • Saved places and collections
  • Search history for quick access

๐Ÿ‘ฅ Social Features

  • Friend system with location sharing
  • Group creation and management
  • Real-time chat messaging
  • Trip sharing with friends
  • Leaderboards and achievements
  • Community-generated content

๐Ÿ“Š Analytics & Insights

  • Trip statistics and history
  • Driving analytics (distance, time, fuel)
  • Carbon footprint tracking
  • Trip export (PDF, CSV, GPX)
  • Personal records and milestones

๐ŸŽ™๏ธ Voice & Accessibility

  • Voice assistant for hands-free control
  • Voice search for destinations
  • Screen reader support (VoiceOver/TalkBack)
  • High contrast mode
  • Dynamic text sizing
  • 9-language support

โš™๏ธ Advanced Features

  • Weather overlay and forecasts
  • Fuel prices near route
  • EV charging stations finder
  • Rest stops and amenities
  • Custom POI creation
  • Cloud backup & sync
  • Dark mode support

๐Ÿ“ฑ Platforms

iOS (62 Screens)

  • Language: Swift 5.9+
  • UI: SwiftUI (iOS 16+)
  • Architecture: MVVM
  • Maps: Mapbox iOS SDK
  • Minimum: iOS 16.0

Android (62 Screens)

  • Language: Kotlin 1.9+
  • UI: Jetpack Compose
  • Architecture: MVVM
  • Maps: Mapbox Android SDK
  • Minimum: Android 8.0 (API 26)

๐Ÿ—๏ธ Architecture

Both platforms follow MVVM (Model-View-ViewModel) architecture with:

  • Clean separation of concerns
  • Reactive state management (StateFlow/ObservableObject)
  • Repository pattern for data access
  • Dependency injection ready
  • Testable components
  • Modern async patterns (Coroutines/Async-Await)

๐Ÿ“‚ Project Structure

navi-app/
├── ios/                          # iOS application
│   └── Navi/
│       ├── Views/                # 62 SwiftUI screens
│       │   ├── Onboarding/       # 10 screens
│       │   ├── Auth/             # 10 screens
│       │   ├── Map/              # 3 screens
│       │   ├── Navigation/       # 12 screens
│       │   ├── Search/           # 12 screens
│       │   ├── Social/           # 10 screens
│       │   ├── Settings/         # 8 screens
│       │   └── Advanced/         # 7 screens
│       ├── ViewModels/           # Business logic
│       ├── Models/               # Data models
│       ├── Services/             # API & services
│       └── Resources/            # Assets & strings
│
├── android/                      # Android application
│   └── app/src/main/
│       ├── java/com/navi/app/
│       │   ├── ui/screens/       # 62 Compose screens
│       │   ├── viewmodels/       # Business logic
│       │   ├── data/             # Models & repositories
│       │   └── utils/            # Utilities
│       └── res/
│           ├── values/           # English (default)
│           ├── values-es/        # Spanish
│           ├── values-fr/        # French
│           ├── values-de/        # German
│           ├── values-it/        # Italian
│           ├── values-pt/        # Portuguese
│           ├── values-ja/        # Japanese
│           ├── values-ko/        # Korean
│           └── values-zh/        # Chinese
│
├── DESIGN_SYSTEM.md             # Design guidelines
├── API_SPEC.md                  # API documentation
├── QC_VALIDATION_REPORT.md      # Quality control report
├── LAUNCH_GUIDE.md              # Comprehensive launch guide
└── README.md                    # This file

๐ŸŽจ Design System

Color Palette

  • Primary Blue: #2563EB
  • Success Green: #10B981
  • Warning Orange: #F59E0B
  • Error Red: #EF4444
  • Gray 900: #111827 (text)
  • Gray 500: #6B7280 (secondary text)

Typography

  • iOS: SF Pro Display (system)
  • Android: Roboto (system)
  • Sizes: 34pt, 28pt, 22pt, 17pt, 14pt, 12pt

Spacing

  • 8pt grid system
  • Common values: 8, 16, 24, 32, 48, 64

Components

  • Buttons: 48pt/dp height, 12pt/dp radius
  • Cards: 16pt/dp padding, subtle shadows
  • Input fields: Consistent styling across platforms

๐ŸŒ Localization

9 Languages Supported:

  1. ๐Ÿ‡ฌ๐Ÿ‡ง English (en) - Default
  2. ๐Ÿ‡ช๐Ÿ‡ธ Spanish (es)
  3. ๐Ÿ‡ซ๐Ÿ‡ท French (fr)
  4. ๐Ÿ‡ฉ๐Ÿ‡ช German (de)
  5. ๐Ÿ‡ฎ๐Ÿ‡น Italian (it)
  6. ๐Ÿ‡ต๐Ÿ‡น Portuguese (pt)
  7. ๐Ÿ‡ฏ๐Ÿ‡ต Japanese (ja)
  8. ๐Ÿ‡ฐ๐Ÿ‡ท Korean (ko)
  9. ๐Ÿ‡จ๐Ÿ‡ณ Chinese (zh)

๐Ÿš€ Getting Started

Prerequisites

iOS:

  • macOS 13.0+ (Ventura)
  • Xcode 15.0+
  • CocoaPods or SPM
  • Mapbox API key

Android:

  • Android Studio Hedgehog (2023.1.1)+
  • JDK 17+
  • Gradle 8.0+
  • Mapbox API key

Installation

iOS:

cd ios/
pod install
open Navi.xcworkspace
# Add Mapbox token to Info.plist
# Build and run (Cmd+R)

Android:

cd android/
echo "MAPBOX_DOWNLOADS_TOKEN=YOUR_TOKEN" >> local.properties
./gradlew assembleDebug
./gradlew installDebug

๐Ÿ“Š Screen Inventory

Onboarding & Authentication (10)

  • SplashScreen - App launch
  • WelcomeScreen - First-time intro
  • OnboardingScreen - Feature showcase
  • PermissionsScreen - Location/notifications
  • SignUpScreen - Account creation
  • EmailVerificationScreen - Email verification
  • ForgotPasswordScreen - Password recovery
  • ResetPasswordScreen - New password
  • PhoneVerificationScreen - SMS verification
  • AccountSetupScreen - Profile completion

Map & Navigation (15)

  • MapScreen - Main map view
  • MapLayersScreen - Layer selection
  • CompassScreen - Orientation
  • TrafficIncidentDetailScreen - Incident info
  • RouteAlternativesScreen - Route comparison
  • RouteOptionsScreen - Route preferences
  • WaypointEditorScreen - Multi-stop editing
  • SavedRoutesScreen - Saved routes
  • RouteHistoryScreen - Past routes
  • LaneGuidanceScreen - Lane assistance
  • ManeuverListScreen - Turn list
  • SpeedLimitScreen - Speed display
  • TurnPreviewScreen - Next turn preview
  • RouteShareScreen - Share routes
  • NavigationSummaryScreen - Trip summary
  • RerouteScreen - Alternative routing

Search & Places (12)

  • SearchScreen - Main search
  • AdvancedSearchScreen - Filtered search
  • SearchHistoryScreen - Past searches
  • PlaceDetailScreen - Place information
  • PlacePhotosScreen - Photo gallery
  • PlaceReviewsScreen - User reviews
  • PlaceContactScreen - Contact info
  • StreetViewScreen - Street view
  • NearbyPlacesScreen - Nearby POIs
  • CategoryBrowserScreen - Browse categories
  • PopularDestinationsScreen - Popular places
  • SavedPlacesScreen - Favorites
  • PlaceCollectionsScreen - Place collections

Social & Community (10)

  • SocialScreen - Friends list
  • FriendRequestsScreen - Pending requests
  • FriendProfileScreen - Friend details
  • GroupsScreen - Group management
  • GroupDetailScreen - Group info
  • GroupChatScreen - Group messaging
  • ChatScreen - Direct messaging
  • LocationHistoryScreen - Shared locations
  • TripSharingScreen - Share trips
  • LeaderboardScreen - Rankings
  • AchievementsScreen - Badges
  • CommunityScreen - User content

Settings & Preferences (8)

  • SettingsScreen - Main settings
  • AccountSettingsScreen - Account management
  • NotificationSettingsScreen - Notifications
  • PrivacySettingsScreen - Privacy controls
  • DataStorageScreen - Storage management
  • VoiceSettingsScreen - Voice preferences
  • DisplaySettingsScreen - Display options
  • AccessibilityScreen - Accessibility
  • LegalScreen - Terms & privacy

Advanced Features (7)

  • VoiceAssistantScreen - Voice commands
  • SafetyAlertsScreen - Safety warnings
  • ParkingScreen - Parking finder
  • WeatherScreen - Weather overlay
  • FuelPricesScreen - Gas prices
  • EVChargingScreen - EV charging
  • RestStopsScreen - Rest areas
  • CustomPOIScreen - Custom POIs
  • BackupSyncScreen - Cloud sync
  • DeveloperOptionsScreen - Advanced settings

Analytics & Export (4)

  • AnalyticsScreen - Trip statistics
  • TripExportScreen - Export data
  • OfflineMapsScreen - Offline management
  • MultiStopRouteScreen - Multi-destination

Other (4)

  • ProfileScreen - User profile
  • AboutScreen - App information
  • HelpScreen - Help & FAQ
  • NotificationsScreen - Notifications
  • LoginScreen - Authentication

Total: 62 screens per platform


๐Ÿงช Testing

Unit Tests

# iOS
xcodebuild test -workspace Navi.xcworkspace -scheme Navi

# Android
./gradlew test

UI Tests

# iOS
xcodebuild test -workspace Navi.xcworkspace -scheme NaviUITests

# Android
./gradlew connectedAndroidTest

๐Ÿ“ฆ Building for Release

iOS

xcodebuild archive -workspace Navi.xcworkspace -scheme Navi
xcodebuild -exportArchive -archivePath build/Navi.xcarchive

Android

./gradlew assembleRelease
./gradlew bundleRelease  # For Play Store

๐Ÿ“ˆ Key Metrics

Metric Target
Screens 62 per platform โœ…
Languages 9 โœ…
Test Coverage 80%+
Crash-free Rate 99.9%
App Launch Time < 2s
API Response Time < 500ms

๐Ÿ›ฃ๏ธ Roadmap

Version 1.1 (Q2 2024)

  • Real-time traffic updates
  • Enhanced voice navigation
  • Offline search
  • Speed camera database

Version 1.2 (Q3 2024)

  • CarPlay/Android Auto
  • Apple Watch/Wear OS
  • Route optimization AI
  • Multi-modal transport

Version 2.0 (Q4 2024)

  • AR navigation
  • 3D buildings
  • Indoor navigation
  • Premium subscription

๐Ÿ“„ Documentation


๐Ÿค Contributing

This is a proprietary project. For internal development:

  1. Create feature branch
  2. Follow code style guidelines
  3. Write tests
  4. Submit pull request
  5. Pass code review

๐Ÿ“ License

Proprietary Software
© 2024 Navi Inc. All rights reserved.

Third-Party Licenses:


๐Ÿ“ž Contact

Website: https://navi.app
Email: hello@navi.app
Support: support@navi.app
Twitter: @naviapp


๐Ÿ™ Acknowledgments

Built with:

Special thanks to:

  • Development team
  • Beta testers
  • Design contributors

Made with โค๏ธ by the Navi team

Status: โœ… Ready for Launch
Version: 1.0.0
Last Updated: January 15, 2024

๐ŸŒ Website

The marketing website is included in the website/ directory.

Live Site: https://navi-website.manus.space

Local Development:

cd website/client
npm install
npm run dev

See website/README.md for full documentation.

About

Professional navigation app with 62 screens per platform (iOS & Android). Features real-time chat, offline maps, multi-stop routes, and 9-language support.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors