> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/m20prs/Sky-AI-Forecast/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get Sky AI Forecast running locally or deployed to the web in under a minute.

## Run locally

Sky AI Forecast has no build step and no dependencies to install. All you need is a modern browser.

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone https://github.com/m20prs/Sky-AI-Forecast.git
    cd Sky-AI-Forecast
    ```
  </Step>

  <Step title="Open index.html in your browser">
    On macOS:

    ```bash theme={null}
    open index.html
    ```

    On Linux:

    ```bash theme={null}
    xdg-open index.html
    ```

    On Windows:

    ```bash theme={null}
    start index.html
    ```

    The app opens directly from the filesystem — no local server required.
  </Step>

  <Step title="Search for a city">
    Type any city name (e.g. `Tokyo`) into the input field and click **Check Weather**.
  </Step>

  <Step title="Explore the forecast views">
    After the results load, use the three tabs to switch between views:

    | Tab                | Function called | What it shows                               |
    | ------------------ | --------------- | ------------------------------------------- |
    | **Current**        | `showCurrent()` | Live temperature and humidity               |
    | **24h Forecast**   | `show24h()`     | Hour-by-hour forecast for the next 24 hours |
    | **16-Day Outlook** | `show30d()`     | Daily high temperatures for up to 16 days   |
  </Step>
</Steps>

<Note>
  If your browser blocks `fetch()` calls from `file://` URLs due to CORS restrictions, serve the files with any static server:

  ```bash theme={null}
  npx serve .
  ```

  Then open `http://localhost:3000` in your browser.
</Note>

## Project structure

The entire app consists of three files:

| File         | Purpose                                                     |
| ------------ | ----------------------------------------------------------- |
| `index.html` | App markup — input, buttons, and display containers         |
| `style.css`  | All visual styling and the logo arc animation               |
| `script.js`  | All logic — geocoding, weather fetching, and view rendering |

## Deploy to the web

<Tabs>
  <Tab title="GitHub Pages">
    <Steps>
      <Step title="Push to GitHub">
        ```bash theme={null}
        git push origin main
        ```
      </Step>

      <Step title="Enable GitHub Pages">
        Go to your repository **Settings → Pages**. Under **Source**, select **Deploy from a branch**, choose **main**, and set the folder to **/ (root)**. Click **Save**.
      </Step>

      <Step title="Visit your site">
        GitHub will publish the app at `https://<your-username>.github.io/Sky-AI-Forecast/`. It may take a minute to deploy.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Netlify">
    <Steps>
      <Step title="Go to Netlify">
        Visit [netlify.com](https://netlify.com) and sign in.
      </Step>

      <Step title="Deploy">
        Drag and drop the `Sky-AI-Forecast` folder onto the Netlify dashboard, or connect your GitHub repository. Leave the **Build command** and **Publish directory** fields blank.
      </Step>

      <Step title="Done">
        Netlify assigns a URL immediately. You can add a custom domain in **Site settings → Domain management**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Vercel">
    <Steps>
      <Step title="Import your repository">
        Visit [vercel.com](https://vercel.com), click **Add New → Project**, and import your GitHub repository.
      </Step>

      <Step title="Configure the project">
        Leave **Framework Preset** as **Other**, **Build Command** blank, and **Output Directory** blank.
      </Step>

      <Step title="Deploy">
        Click **Deploy**. Vercel will publish the app and provide a URL.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  Because the app makes API calls to Open-Meteo directly from the browser, there is no backend to configure. Any static hosting platform works.
</Tip>