wiki: docs: Introduce fastboot package flashing guide

Signed-off-by: HeroBuxx <me@herobuxx.me>

Author: herobuxx

docs/fastboot_package.md

@@ -0,0 +1,151 @@
+---
+slug: /fastboot-package
+pagination_next: null
+pagination_prev: null
+title: "Flashing Fastboot Packages"
+sidebar_class_name: hidden
+---
+
+# Flashing Fastboot Packages
+
+:::warning Device Compatibility Required
+Fastboot packages can **only be flashed on a limited set of devices**. Not all Android devices support fastboot package flashing. Please read the device requirements section below carefully to ensure your device is compatible.
+:::
+
+## Device Requirements
+
+### Supported Devices
+
+Fastboot package flashing is supported only on devices that meet **ALL** of the following criteria:
+
+- **Android Version:** Launched with Android 10 or later
+- **Dynamic Partitions:** Device must support Dynamic Partitions (`super` partition)
+- **Fastbootd:** Device must have fastbootd support (userspace fastboot)
+
+These features typically became standard in devices released with Android 10+, but some older flagships may also support them.
+
+### Unsupported Devices
+
+The following device types are **NOT compatible** with fastboot package flashing:
+
+- **Samsung devices** - Samsung uses Odin protocol (proprietary download mode) and does not support fastboot packages
+- **Older devices** - Devices released before Android 10 without Dynamic Partitions support (even if the community has implemented a dynamic partition retrofit)
+- **Devices without fastbootd** - Devices that only support bootloader-level fastboot, not userspace fastboot
+- **Some custom ROM implementations** - Devices with custom bootloaders that don't implement fastbootd
+
+:::caution Samsung Devices
+If you own a Samsung device, do **not** attempt to use fastboot package flashing. Please refer to your device's specific installation method instead.
+:::
+
+## Understanding Fastboot Packages
+
+A fastboot package (often named with `.zip` extension) is a complete ROM package designed to be flashed through fastboot in a single operation. Unlike traditional ADB sideloading, fastboot packages:
+
+- Are flashed directly to partitions via fastboot protocol
+- Support flashing multiple partitions simultaneously
+- Require the device to be in fastbootd/userspace fastboot mode
+- Work with Dynamic Partition layouts
+
+:::note Availability
+Fastboot packages are available since **Halcyon 16.0 Bloom** and later versions.
+:::
+
+## Prerequisites
+
+:::danger Remove Accounts and Lock Screen - CRITICAL
+Before flashing, **you MUST remove**:
+- Your lock screen (PIN, pattern, password, fingerprint, face unlock)
+- All accounts (Google, Samsung, Xiaomi, etc.)
+
+**Failure to do so can:**
+- Lock you out of your device via Factory Reset Protection (FRP), making it unusable
+- **Permanently damage the TEE (Trusted Execution Environment)** on some devices
+- **Render biometric hardware (fingerprint sensor) permanently unusable** on affected devices
+
+This damage has been confirmed on multiple devices and cannot be repaired after flashing. This is not reversible.
+:::
+
+Before flashing a fastboot package, ensure you have:
+
+- **ADB/Fastboot tools** installed on your computer
+- **USB drivers** installed (if on Windows)
+- **Unlocked bootloader** (device-dependent)
+- **USB cable** capable of data transfer (not just charging)
+- **Removed all accounts and lock screen** from your device
+
+## Installation Steps
+
+### 1. Enter Fastboot Mode
+
+The method varies by device. Common combinations include:
+
+- Power + Volume Down
+- Power + Volume Up
+- Power + Volume Down + Volume Up (press simultaneously)
+
+Consult your specific device documentation for the exact key combination.
+
+### 2. Connect to Computer
+
+Connect your device to your PC via USB cable and verify it's detected:
+
+```
+fastboot devices
+```
+
+You should see your device listed with a serial number.
+
+:::caution Check Connection
+If your device is not listed, check USB drivers and try a different USB port.
+:::
+
+### 3. Wipe the Device
+
+Before flashing, wipe the device to ensure a clean installation:
+
+```
+fastboot -w
+```
+
+This command will erase all data on your device.
+
+### 4. Flash the Package
+
+Download the fastboot package for your device and run:
+
+```
+fastboot update fastboot-halcyon_XXXXXX.zip
+```
+
+Example: `fastboot-halcyon_surya-16.2-20260210-1800-Alpha-GMS-signed.zip`
+
+*(Replace with your device's actual package filename)*
+
+This command will:
+- Extract all partitions from the package
+- Flash them to the appropriate partitions
+- Verify each partition after flashing
+- Automatically reboot when complete
+
+### 5. Verify Installation
+
+After flashing completes and the device reboots:
+
+```
+fastboot reboot
+```
+
+Or allow the automatic reboot to proceed. Your device should boot into the newly flashed ROM.
+
+## Getting Help
+
+If you encounter issues not covered here:
+
+- Check your **device-specific documentation**
+- Ask in our **[Telegram group](https://t.me/hlcynprjctchat)** for community support
+- Verify you followed **all prerequisites** correctly
+- Provide your **device codename** and **exact error message** when asking for help
+
+:::info Need Device-Specific Help?
+Each officially supported device has its own documentation page with device-specific instructions and troubleshooting. Refer to the [Official Devices](/devices) section for your device.
+:::

docs/official_devices/blacklisted.md

@@ -0,0 +1,17 @@
+---
+slug: /devices/blacklisted
+pagination_next: null
+pagination_prev: null
+title: "Blacklisted Devices"
+sidebar_class_name: hidden
+---
+
+:::info
+The blacklist may be lifted if a new maintainer provides a fresh, original device tree (not a fork of the previous maintainer’s work).
+:::
+
+### Motorola
+- [Motorola Edge 40 Neo (manaus)](/devices/manaus)
+
+### Xiaomi
+- Redmi Note 14 Pro 5G/POCO X7 (malachite)

docs/official_devices/xiaomi/alioth.md

@@ -29,6 +29,10 @@ title: "POCO F3 / Mi 11x / Redmi K40 (alioth)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/beryl.md

@@ -30,6 +30,10 @@ title: "Redmi Note 14 5G / 14 SE / POCO M7 Pro 5G (beryl)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/citrus.md

@@ -29,6 +29,10 @@ title: "POCO M3 (citrus)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/garnet.md

@@ -30,6 +30,10 @@ title: "Redmi Note 13 Pro 5G / POCO X6 5G (garnet)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/lime.md

@@ -29,6 +29,10 @@ title: "Redmi 9T/9T NFC/8 Power/Note 9 4G (lime)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/marble.md

@@ -29,6 +29,10 @@ title: "POCO F5 / Redmi Note 12 Turbo (marble)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/peridot.md

@@ -29,6 +29,10 @@ title: "POCO F6 / Redmi Turbo 3 (peridot)"
 Make sure to backup your data before proceeding.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.
 2. Connect your device to your PC via USB.

docs/official_devices/xiaomi/rodin.md

@@ -32,6 +32,10 @@ title: "POCO X7 Pro / Redmi Turbo 4 (rodin)"
 Before proceeding, please remove all lockscreen security (PIN, password, pattern, and fingerprint) and ensure you have backed up your data. Keeping any lockscreen credentials active while switching ROMs can cause the fingerprint sensor to stop working, and in many cases this issue cannot be easily recovered. We are not responsible for any malfunction resulting from not following these steps.
 :::
 
+### Fastboot package installation
+
+If you want to install using the Fastboot package, the complete installation guide is available [here](/fastboot-package). Otherwise, you can follow the instructions below to flash via recovery using ADB sideload.
+
 ### Installing Recovery
 
 1. Enter fastboot mode by using a key combination `Power + Vol Down`.