Navigating the App

Navigating the App

SwiftReporter uses a stack-based navigation system with header controls and direct navigation between screens.

Primary Navigation Structure

Header Navigation

  • Custom Header: Located at the top right of most screens
  • Access Controls: Contains navigation options and user account functions
  • Back Navigation: Most screens include a back arrow or navigation control to return to previous screens

Screen Stack Navigation

The app follows a logical flow structure:

---
title: App Navigation Flow
---
graph TD
    A[Login/Signup] --> B[Home Screen]
    B --> C[Template Editor]
    B --> D[Inspection Details]
    B --> E[Profile]
    B --> F[Settings]
    B --> G[Archived Inspections]
    D --> H[Observation Screen]
    D --> I[Report View]
    I --> J[Report Preview/Download]
    H --> K[Camera Interface]

Main Navigation Paths

From Home Screen

  1. Inspection Management:

    • Tap any inspection in the list → Opens Inspection Details screen
    • Tap "Create Inspection" → Creates new inspection and opens Inspection Details
  2. Template Management:

    • Tap "Edit Template" → Opens Template Editor screen
  3. User Account:

    • Access through Custom Header → Profile, Settings, Archived Inspections, Sign Out

From Inspection Details Screen

  1. Observation Management:

    • Tap "Add Observation" → Creates new observation and opens Observation screen
    • Tap any existing observation → Opens Observation screen for that observation
  2. Report Management:

    • Tap "Complete Report" → Opens Report editing interface
    • Tap "Details" → Opens detailed inspection information editor
    • Tap "Download Report" → Directly generates and downloads PDF for sharing
  3. Photo Management:

    • Cover photo area → Opens photo selection/camera interface

From Observation Screen

  1. Content Capture:

    • Audio recording controls → Start/stop recording without leaving screen
    • "Take Photos" button → Opens Camera interface
    • Category/Subcategory dropdowns → Edit observation classification
  2. AI Features:

    • Wand button (when visible) → Trigger AI summarization of audio content

Navigation Controls

Header Elements

  • Screen Titles: Each screen displays its function in the header (e.g., "Home", "Inspection", "Observation")
  • Back Navigation: Automatic back buttons where appropriate
  • Custom Header Button: Access to app-wide functions

Stack Navigation Behavior

  • Forward Navigation: Tapping items pushes new screens onto the stack
  • Back Navigation: System back gestures or header controls pop screens from stack
  • Modal Screens: Some interfaces (like camera) open as modals over existing content

Deep Navigation Features

  • Direct URL Navigation: The app supports direct navigation to specific inspections and observations via URL parameters
  • State Preservation: Navigation state is maintained when returning to previous screens

Screen-Specific Navigation

Camera Interface

  • Modal Presentation: Opens over existing screens
  • Close Control: Dedicated close button to return to previous screen
  • Capture Flow: After taking photos, automatically returns to previous context

Report Editor

  • Edit/Complete Modes: Toggle between editing and viewing modes
  • Section Navigation: Direct editing of specific report sections
  • Template Editing: In-line editing of template structure within reports

Template Editor

  • Category Management: Navigate between different template categories
  • Modal Dialogs: Select templates, create new templates via modal interfaces

Tips for Efficient Navigation

💡 Quick Access: Use the Custom Header button for frequently accessed functions like Profile and Settings.

📱 Gesture Navigation: The app supports standard mobile navigation gestures including swipe-back where available.

🔄 Context Preservation: The app remembers your place in complex workflows, so you can navigate freely without losing progress.

Direct Actions: Many screens allow direct actions (like creating observations) without additional navigation steps.

Related