# sanskar9067/skyscanner architecture

> Architecture diagram of the GitHub repository sanskar9067/skyscanner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanskar9067/skyscanner
- Repository: https://github.com/sanskar9067/skyscanner

## Overview

##### Project Type and Purpose
- This is a single-page front-end web application (a ReactJS SPA) styled with Tailwind CSS.
- Purpose: Detect user location (via browser Geolocation API), fetch real-time weather and time data from two external REST services (OpenWeather API and API Ninjas), and display it. It also supports manual location search (via a geocoding API).

##### Key Architectural Layers and Components
a. Presentation Layer (Browser / Client)
- index.html (public/index.html) – host container for the React app
- App.js – root React component, applies Context providers and renders Home page
- Home.js (src/pages/Home.js) – orchestrates two tabs: “Current Location” and “Search Location”
- React-Tabs (TabComponent.js) – UI navigation between the two modes
- UI Components under src/components:
– Navbar.js + DarkModeToggle.js (theme switcher)
– Weather.js + WeatherSearch.js (input for manual search)
– Heroes.js (hero banner)
– Spinner.js (loading indicator)
– Footer.js
- DarkModeContext.js (src/context) – React Context and Provider for global theme state

b. Business Logic Layer
- App.js & Home.js orchestrate data retrieval and state updates
- useState/useEffect hooks manage local component state for weather/time data
- Axios (via React) handles HTTP requests to external APIs

c. External Services
- Browser Geolocation API – to fetch user’s latitude/longitude
- OpenWeather API – returns weather and local time details given coordinates
- API Ninjas Geocoding API – converts user-entered location names into coordinates

##### Relationships and Data Flows
1. User opens the app → index.html loads → index.js renders <App/>
2. App.js wraps children with DarkModeContext Provider → passes down `darkMode` toggle
3. Home.js renders TabComponent:
- Tab “Current Location”:
– Calls Geolocation API → retrieves coords → Axios → OpenWeather → setState → Weather.js displays data
- Tab “Search Location”:
– WeatherSearch.js captures place name → Axios → API Ninjas → coords → Axios → OpenWeather → state → Weather.js displays
4. DarkModeToggle.js reads/writes theme flag in Context → entire UI re-renders with Tailwind dark mode classes

##### Architectural Patterns and Principles
- Component-based UI (React functional components)
- Single source of truth for theme (Context API)
- Separation of concerns: Presentation vs Data-fetching logic vs External integrations
- Hook-based state management (useState/useEffect)

##### Detailed Elements
- Tailwind CSS config (tailwind.config.js) as a styling cross-cutting concern

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Browser (Client)"
    IDX["index.html"]:::component
    IDXJS["index.js"]:::component
    APP["App.js"]:::component
    DMContext["DarkModeContextProvider"]:::provider
    NAV["Navbar.js"]:::component
    DMT["DarkModeToggle.js"]:::component
    TC["TabComponent.js"]:::component
    HOME["Home.js"]:::component
    HS["Heroes.js"]:::component
    WEA["Weather.js"]:::component
    WES["WeatherSearch.js"]:::component
    SPI["Spinner.js"]:::component
    FTR["Footer.js"]:::component
    CSS["index.css"]:::component
  end

  IDX -->|"loads"| IDXJS
  IDXJS -->|"renders <App/>"| APP
  APP -->|"wraps children"| DMContext
  DMContext --> NAV
  DMContext --> DMT
  DMContext --> TC
  DMContext --> HOME

  HOME --> HS
  HOME --> TC
  HOME --> WEA
  HOME --> WES
  HOME --> SPI
  HOME --> FTR

  TC -->|"selects 'Current Location'"| LOCFLOW[/"Current Location Flow"/]:::component
  TC -->|"selects 'Search Location'"| SEAFLOW[/"Search Location Flow"/]:::component

  LOCFLOW -->|"useEffect / calls"| GEOLOC["Geolocation API"]:::external
  GEOLOC -->|"coords"| LOCFLOW
  LOCFLOW -->|"axios GET /weather?lat={lat}&lon={lon}"| OWP["OpenWeather REST API"]:::external
  OWP -->|"weather/time data"| LOCFLOW
  LOCFLOW --> WEA

  SEAFLOW --> WES
  WES -->|"axios GET /geocode?location={query}"| NINJAS["API Ninjas Geocoding API"]:::external
  NINJAS -->|"coords"| WES
  WES -->|"axios GET /weather?lat={lat}&lon={lon}"| OWP
  OWP -->|"weather/time data"| SEAFLOW
  SEAFLOW --> WEA

  DMT -->|"toggles theme"| DMContext

  TAIL["tailwind.config.js"]:::external

  click IDX "https://github.com/sanskar9067/skyscanner/blob/main/public/index.html"
  click APP "https://github.com/sanskar9067/skyscanner/blob/main/src/App.js"
  click IDXJS "https://github.com/sanskar9067/skyscanner/blob/main/src/index.js"
  click HOME "https://github.com/sanskar9067/skyscanner/blob/main/src/pages/Home.js"
  click TC "https://github.com/sanskar9067/skyscanner/blob/main/src/components/TabComponent.js"
  click NAV "https://github.com/sanskar9067/skyscanner/blob/main/src/components/Navbar.js"
  click DMT "https://github.com/sanskar9067/skyscanner/blob/main/src/components/DarkModeToggle.js"
  click DMContext "https://github.com/sanskar9067/skyscanner/blob/main/src/context/DarkModeContext.js"
  click HS "https://github.com/sanskar9067/skyscanner/blob/main/src/components/Heroes.js"
  click WEA "https://github.com/sanskar9067/skyscanner/blob/main/src/components/Weather.js"
  click WES "https://github.com/sanskar9067/skyscanner/blob/main/src/components/WeatherSearch.js"
  click SPI "https://github.com/sanskar9067/skyscanner/blob/main/src/components/Spinner.js"
  click FTR "https://github.com/sanskar9067/skyscanner/blob/main/src/components/Footer.js"
  click TAIL "https://github.com/sanskar9067/skyscanner/blob/main/tailwind.config.js"
  click CSS "https://github.com/sanskar9067/skyscanner/blob/main/src/index.css"

  classDef component fill:#cce5ff,stroke:#004085,color:#004085
  classDef provider fill:#ffe5b4,stroke:#cc8400,color:#cc8400
  classDef external fill:#d4edda,stroke:#155724,color:#155724
```
