# Documentation

- [Introduction](/docs): Documentation index for ipa-forge, a data-driven iOS IPA patcher for AltStore Classic sideloading.
- [Installation](/docs/installation): Install ipa-forge from PyPI and run your first patch in under a minute.

- **Guides**
- [Adding a New App](/docs/adding-an-app): End-to-end playbook for porting a new app to ipa-forge, patch set layout, hook dylib conventions, and the device-test loop.
- [Adding a Feature](/docs/adding-a-feature): Conventions for adding a feature to an existing ipa-forge hook dylib, key, default, implementation, settings row, hooks declaration.

- **Reference**
- [Usage](/docs/usage): Full CLI and web GUI reference for forge: patch, inspect, validate, hooks, and analysis commands, plus signing identity and profile setup.
- [Patch Reference](/docs/patch-reference): Complete reference for ipa-forge patch definition YAML: every operation type, field, version-matching rule, and the hooks block.
- [Reverse Engineering](/docs/reverse-engineering): forge analysis: class-dump, strings, symbols, security posture, IL2CPP references, and version diffing for decrypted IPAs.
- [Troubleshooting](/docs/troubleshooting): Every ipa-forge error message mapped to its cause and fix.
- [Device Testing](/docs/altstore-device-testing): Manual checklist for testing a patched IPA on a real iPhone via AltStore Classic.

- **Contributing to ipa-forge**
- [Architecture](/docs/architecture): How the ipa-forge engine works: the 17-stage pipeline, hard constraints, component map, and two real bugs found empirically.
- [Extensibility](/docs/extensibility): How to extend ipa-forge with new patch operation types and signing providers.
- [Releasing](/docs/releasing): How to cut a new ipa-forge release: PyPI Trusted Publishing and GitHub Releases via CI.