# OpenWrt/ImmortalWrt IPQ60XX Build (Woodpecker)

This repo is a build-orchestration repo that compiles IPQ60XX firmware using Woodpecker CI.

## Quick Start

1. **Set up Woodpecker**: Enable this repository in Woodpecker UI
2. **Optional config**: Edit `Config/GENERAL.local.txt` to add custom packages
3. **Trigger build**: Push to `main` branch or click manual trigger

## Architecture

### Three upstream layers

| Layer | Purpose | Source |
|-------|---------|--------|
| SOURCE | Firmware source code | `VIKINGYFY/immortalwrt.git` (main branch) |
| CI-TEMPLATE | Config templates | `davidtall/OpenWRT-CI` (GENERAL.txt dynamic) |
| YOUR-DELTA | Your customizations | This repo (edit only here) |

### Build targets

- **IPQ60XX-WIFI-YES**: Based on VIKINGYFY/OpenWRT-CI
- **IPQ60XX-WIFI**: Based on davidtall/OpenWRT-CI

Both targets merge: Device Config + Upstream GENERAL + Your LOCAL overrides

## How to add packages

### Feeds packages
Add to `Config/GENERAL.local.txt`:
```
CONFIG_PACKAGE_luci-app-xxx=y
CONFIG_PACKAGE_openssh-sftp-server=y
```

### Custom packages
Edit `Scripts/Packages.sh` to clone custom repos

## Documentation

Detailed guide: See [docs/SKILLS.md](docs/SKILLS.md)

## Artifacts

Build outputs are saved to `artifacts/` directory:
- `artifacts/ipq60xx-wifi-yes/` - Firmware from WIFI-YES config
- `artifacts/ipq60xx-wifi/` - Firmware from WIFI config

## Dependencies

This repository pulls configs from:
- [VIKINGYFY/OpenWRT-CI](https://github.com/VIKINGYFY/OpenWRT-CI)
- [davidtall/OpenWRT-CI](https://github.com/davidtall/OpenWRT-CI)

Source firmware:
- [VIKINGYFY/immortalwrt](https://github.com/VIKINGYFY/immortalwrt)