Skip to content

PROJECT_OVERVIEW.md

Latest commit

 

History

History
334 lines (261 loc) · 7.82 KB

PROJECT_OVERVIEW.md

File metadata and controls

334 lines (261 loc) · 7.82 KB

🐉 DragonBornOS - Project Overview

Date: 2026-03-26
Lead Developer: methodwhite
Base: AOSP 13 (Android 13)
Status: ACTIVE DEVELOPMENT

📱 SUPPORTED DEVICES

Device Codename SoC Status Maintainer
Moto Edge 30 Neo neo Snapdragon 695 ✅ STABLE methodwhite
Xiaomi POCO X3 Pro vayu Snapdragon 860 🔄 PORTING methodwhite
Huawei P Smart 2019 HWSTK-HF Kirin 710 🔄 PORTING methodwhite

🎯 PROJECT GOALS

Primary Objectives

  1. ✅ Port DragonBornOS from Moto Edge 30 Neo to 2 new devices
  2. ✅ Maintain security and privacy features
  3. ✅ Provide stable daily builds
  4. ✅ Active community support

Secondary Objectives

  • ⬜ Add more devices in Q2 2026
  • ⬜ Android 14 base in Q3 2026
  • ⬜ Dragon AI improvements
  • ⬜ OTA infrastructure

🏗️ PROJECT STRUCTURE

$HOME/Projects/DragonBornOS/
├── README.md                    # Project overview
├── build.sh                     # Build automation script
├── setup.sh                     # Environment setup script
├── device/
│   ├── motorola/neo/           # Moto Edge 30 Neo device tree
│   ├── xiaomi/vayu/            # Xiaomi POCO X3 Pro device tree
│   └── huawei/HWSTK-HF/        # Huawei P Smart 2019 device tree
├── kernel/
│   ├── motorola/neo/           # Kernel for Moto Edge 30 Neo
│   ├── xiaomi/sm8250/          # Kernel for POCO X3 Pro
│   └── huawei/kirin710/        # Kernel for Huawei P Smart
├── vendor/                      # Proprietary blobs (to be cloned)
├── docs/
│   └── PORTING_GUIDE.md        # Porting documentation
├── tools/                       # Build tools
└── roms/                        # Compiled ROMs (output)

🛠️ QUICK START

1. Setup Environment

cd $HOME/Projects/DragonBornOS
./setup.sh

2. Build for Device

# Moto Edge 30 Neo (existing)
./build.sh neo build

# Xiaomi POCO X3 Pro
./build.sh vayu build

# Huawei P Smart 2019
./build.sh HWSTK build

3. Flash ROM

adb reboot bootloader
fastboot flash boot boot.img
fastboot flash system system.img
fastboot flash vendor vendor.img
fastboot reboot

📊 DEVELOPMENT STATUS

Moto Edge 30 Neo (neo)

  • Device Tree: ✅ COMPLETE
  • Kernel: ✅ COMPLETE
  • Vendor Blobs: ✅ COMPLETE
  • Build Status: ✅ STABLE
  • Daily Builds: ✅ AVAILABLE
  • Known Issues: None

Xiaomi POCO X3 Pro (vayu)

  • Device Tree: 🔄 IN PROGRESS
  • Kernel: 🔄 IN PROGRESS
  • Vendor Blobs: ⏳ PENDING
  • Build Status: 🔄 TESTING
  • Daily Builds: ⏳ SOON
  • Known Issues:
    • ⚠️ VoLTE needs testing
    • ⚠️ Fingerprint needs testing

Huawei P Smart 2019 (HWSTK-HF)

  • Device Tree: 🔄 IN PROGRESS
  • Kernel: 🔄 IN PROGRESS
  • Vendor Blobs: ⏳ PENDING
  • Build Status: 🔄 TESTING
  • Daily Builds: ⏳ SOON
  • Known Issues:
    • ⚠️ No Google Services (use microG)
    • ⚠️ Camera needs proprietary blobs
    • ⚠️ Bootloader unlock required

🔧 BUILD REQUIREMENTS

Hardware

  • CPU: 8+ cores (16+ recommended)
  • RAM: 32GB minimum (64GB recommended)
  • Storage: 500GB+ SSD (1TB+ recommended)
  • OS: Ubuntu 20.04/22.04 LTS

Software

  • Java: OpenJDK 11
  • Python: 3.8+
  • Repo: Latest version
  • Git: Latest version

Dependencies

sudo apt install -y bc bison build-essential ccache curl \
    flex g++ gcc git gnupg liblz4-tool libncurses5 \
    libncurses5-dev libssl-dev libxml2 libxml2-utils lzop \
    maven pngcrush python3 rsync schedtool squashfs-tools \
    xsltproc zip zlib1g-dev imagemagick openjdk-11-jdk \
    adb fastboot

📁 KEY FILES

Configuration Files

File Purpose
device/*/BoardConfig.mk Device-specific board configuration
device/*/device.mk Device-specific build rules
device/*/AndroidProducts.mk Product definitions
vendor/dragonborn/config/common.mk Common DragonBornOS config

Build Scripts

Script Purpose
build.sh Automated build system
setup.sh Environment setup
extract-files.sh Extract vendor blobs
generate_otapackage.sh Generate OTA updates

🧪 TESTING CHECKLIST

Before Release

  • Boot animation works
  • Touchscreen responsive
  • WiFi connects
  • Bluetooth pairs
  • RIL (calls/SMS) works
  • Mobile data works
  • Camera takes photos
  • Audio playback works
  • Microphone records
  • GPS gets lock
  • Sensors work (accelerometer, gyroscope, proximity)
  • Charging works
  • USB transfer works
  • SD card detected (if applicable)
  • Fingerprint works (if applicable)
  • Face unlock works (if applicable)
  • SELinux Enforcing
  • SafetyNet passes (optional)

📊 TIMELINE

Phase 1: Setup (DONE ✅)

  • Create project structure
  • Write build scripts
  • Create device trees (base)
  • Write documentation

Phase 2: Porting (IN PROGRESS 🔄)

  • Moto Edge 30 Neo (existing)
  • Xiaomi POCO X3 Pro (50%)
  • Huawei P Smart 2019 (30%)

Phase 3: Testing (NEXT ⏳)

  • Build all devices
  • Flash and boot
  • Test all features
  • Fix bugs

Phase 4: Release (PLANNED 📅)

  • First public builds
  • Community testing
  • Bug fixes
  • Official release

🐛 KNOWN ISSUES

Xiaomi POCO X3 Pro

Issue Severity Status
VoLTE may not work Medium Investigating
Fingerprint sensor Medium Testing
Camera quality Low Optimizing

Huawei P Smart 2019

Issue Severity Status
No Google Services High Using microG
Camera HAL High Extracting blobs
Bootloader unlock Critical User responsibility

📞 COMMUNICATION

Official Channels

  • Website: dragonbornos.com (TBD)
  • Telegram: @DragonBornOS (TBD)
  • XDA: DragonBornOS Forum (TBD)
  • GitHub: @DragonBornOS (TBD)

Device-Specific

  • Moto Edge 30 Neo: @DragonBornOS_neo (TBD)
  • POCO X3 Pro: @DragonBornOS_vayu (TBD)
  • Huawei P Smart: @DragonBornOS_HWSTK (TBD)

👥 TEAM

Core Developers

  • methodwhite - Lead Developer, All Devices

Contributors Needed

  • Kernel developers
  • Device tree maintainers
  • Testers
  • Documentation writers

📚 RESOURCES

Documentation

External Resources

⚖️ LICENSE

DragonBornOS is licensed under:

  • Apache License 2.0 - AOSP base
  • GPL v2 - Kernel
  • MIT - DragonBornOS applications

🏁 ROADMAP

Q1 2026 (Jan-Mar)

  • ✅ Project setup
  • ✅ Device trees created
  • 🔄 First builds for vayu and HWSTK

Q2 2026 (Apr-Jun)

  • ⬜ Stable releases for all devices
  • ⬜ OTA infrastructure
  • ⬜ Community testing

Q3 2026 (Jul-Sep)

  • ⬜ Android 14 base
  • ⬜ New devices (TBD)
  • ⬜ Dragon AI 2.0

Q4 2026 (Oct-Dec)

  • ⬜ Android 15 planning
  • ⬜ More device ports
  • ⬜ Dragon OS ecosystem

🎯 SUCCESS METRICS

Development

  • ✅ 3 devices supported
  • ⬜ 10+ devices by end of 2026
  • ⬜ Weekly builds
  • ⬜ < 48h bug fix time

Community

  • ⬜ 1000+ Telegram members
  • ⬜ 100+ daily downloads
  • ⬜ Active forum presence
  • ⬜ Regular contributor meetings

DragonBornOS - Rise from the ashes of stock Android 🐉

Last Updated: 2026-03-26
Version: 1.0
Status: ACTIVE DEVELOPMENT