# 8Air Downloads Repository

Official distribution repository for [download.8air.dev](https://download.8air.dev/).

All application binaries, installers, and manifests are deployed automatically to Netlify Global Edge CDN from the `main` branch of this repository.

---

## 🗂️ Mandatory Directory Organization Standard

All files in this repository **must** strictly follow the standardized 3-tier hierarchy:

$$\text{company} \,/\, \text{appname} \,/\, \text{version} \,/\, \text{[app]}$$

### Format Specification
- **`company/`**: The lowercase company, vendor, or organization name (e.g., `8air`, `twocanoes`).
- **`appname/`**: The lowercase application or utility name (e.g., `mail`, `xcreds`).
- **`version/`**: The version number string without leading 'v' (e.g., `1.0.1`, `1.0.0`, `5.8`).
- **`[app]`**: The binary or installer file(s) for that specific release (e.g., `.pkg`, `.zip`, `.apk`, `.aab`).

> [!IMPORTANT]
> **No Root Aliases or Redirects:** All packages reside strictly within their designated `company/appname/version/` folder. Direct URLs match this exact path.

---

## 🌲 Current Repository Structure

```text
qwer8qaz8/download/
├── index.html                        # Branded web portal at https://download.8air.dev/
├── README.md                         # This organization guide & complete download catalog
│
├── 8air/
│   └── mail/                         # 8Air Mail Application
│       ├── version.json              # Latest version manifest for auto-updaters
│       ├── 1.0.1/                    # Release v1.0.1 (macOS & unified suite)
│       │   ├── 8Air-Mail-macOS.zip   # macOS application archive (v1.0.1)
│       │   ├── 8Air-Mail-Installer.pkg # macOS Bootstrap PKG for MDM/ABM (v1.0.1)
│       │   ├── 8Air-Mail-Android.apk # Android release package
│       │   └── version.json          # v1.0.1 metadata manifest
│       └── 1.0.0/                    # Release v1.0.0 (Android & Google Play)
│           ├── 8Air-Mail-Android.apk # Standalone Android APK (v1.0.0)
│           ├── 8Air-Mail-v1.0.0.aab  # Google Play Console App Bundle (v1.0.0)
│           └── version.json          # v1.0.0 metadata manifest
│
└── twocanoes/
    └── xcreds/                       # Twocanoes XCreds
        └── 5.8/                      # Release v5.8
            └── XCreds-5.8.pkg        # Microsoft Entra ID macOS login & password sync
```

---

## 🤖 Instructions for Future AI Agents & Developers

When instructed to add a new application, package, or version:

1. **Create the Specific Version Directory:**
   ```bash
   mkdir -p <company>/<appname>/<version>
   ```
   *Example:* `mkdir -p 8air/mail/1.0.2` or `mkdir -p twocanoes/xcreds/5.9`

2. **Place the Release Binary:**
   - Copy or move the built package into `<company>/<appname>/<version>/`.
   - Preserve clean, recognizable filenames (e.g., `8Air-Mail-macOS.zip`, `8Air-Mail-Installer.pkg`, `XCreds-5.9.pkg`).

3. **Compute and Verify SHA-256 Checksums:**
   ```bash
   shasum -a 256 <company>/<appname>/<version>/<filename>
   ```

4. **Update or Create `version.json`:**
   - Place a `version.json` in the version folder and update `<company>/<appname>/version.json` with:
     - `"version"`: `"<version>"`
     - `"downloadUrl"`: `"https://download.8air.dev/<company>/<appname>/<version>/<filename>"`
     - Updated SHA-256 hash map.

5. **Update Documentation & Web Portal:**
   - Add the new version and direct links to **Available Packages & Direct Download Links** in this `README.md`.
   - Update download links and checksum cards in `index.html`.

6. **Commit and Deploy:**
   ```bash
   git add -A
   git commit -m "feat(<company>/<appname>): add version <version>"
   git push origin main
   ```
   Netlify automatically builds and deploys to `download.8air.dev` globally in ~15 seconds.

---

## 📦 Available Packages & Direct Download Links

### 8Air — Mail (`8air/mail/`)

#### Version 1.0.1 (Current macOS & Unified Suite)

| Package | Format | Size | Direct Download URL | SHA-256 Checksum |
| :--- | :--- | :--- | :--- | :--- |
| **macOS App Archive** | `.zip` | 5.8 MB | [https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-macOS.zip](https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-macOS.zip) | `707d35d3178fec9a28e0085486531003e35a0c5e4ce39d5f7f7ffb9acc26fbcd` |
| **macOS Bootstrap PKG** | `.pkg` | 2.2 KB | [https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-Installer.pkg](https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-Installer.pkg) | `9d45f9e296986d53a132099b60a2320d3649f5e277d55f90b6675a2bcd77c135` |
| **Android Release APK** | `.apk` | 3.5 MB | [https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-Android.apk](https://download.8air.dev/8air/mail/1.0.1/8Air-Mail-Android.apk) | `fead654a2924cbe592bbc7adec54d7bc8929117b7fcec4d2836b4d9160c2ed44` |
| **Update Manifest (v1.0.1)** | `.json` | 1 KB | [https://download.8air.dev/8air/mail/1.0.1/version.json](https://download.8air.dev/8air/mail/1.0.1/version.json) | — |

#### Version 1.0.0 (Android & Google Play Console)

| Package | Format | Size | Direct Download URL | SHA-256 Checksum |
| :--- | :--- | :--- | :--- | :--- |
| **Android Release APK** | `.apk` | 3.5 MB | [https://download.8air.dev/8air/mail/1.0.0/8Air-Mail-Android.apk](https://download.8air.dev/8air/mail/1.0.0/8Air-Mail-Android.apk) | `fead654a2924cbe592bbc7adec54d7bc8929117b7fcec4d2836b4d9160c2ed44` |
| **Google Play App Bundle** | `.aab` | 3.8 MB | [https://download.8air.dev/8air/mail/1.0.0/8Air-Mail-v1.0.0.aab](https://download.8air.dev/8air/mail/1.0.0/8Air-Mail-v1.0.0.aab) | `a90e3b77a896d942980c9bf61e46850c1c84a8f4797f3a04220b432026226fea` |
| **Update Manifest (v1.0.0)** | `.json` | 1 KB | [https://download.8air.dev/8air/mail/1.0.0/version.json](https://download.8air.dev/8air/mail/1.0.0/version.json) | — |

#### Latest Manifest Pointer
- **Active In-App Updater Endpoint:** [https://download.8air.dev/8air/mail/version.json](https://download.8air.dev/8air/mail/version.json)

---

### Twocanoes — XCreds (`twocanoes/xcreds/`)

#### Version 5.8

| Package | Format | Size | Direct Download URL | SHA-256 Checksum |
| :--- | :--- | :--- | :--- | :--- |
| **XCreds 5.8 Installer** | `.pkg` | 5.6 MB | [https://download.8air.dev/twocanoes/xcreds/5.8/XCreds-5.8.pkg](https://download.8air.dev/twocanoes/xcreds/5.8/XCreds-5.8.pkg) | `ecfe968c5a85a9878ccc581a9788272ac1cb47f1dc35581fac618a2467a1ce91` |