# Porting Notes

## Windows

Built locally with PyInstaller:

```powershell
py -3.10 -m PyInstaller --noconfirm AnimeCharacterMaker.spec
powershell -NoProfile -ExecutionPolicy Bypass -File .\create_release_packages.ps1
```

Download package:

```text
site/downloads/AnimeCharacterMaker-windows.zip
```

## macOS

The macOS port is configured as a native PyInstaller `.app` bundle:

```bash
./build_macos_app.sh
```

This must run on macOS. PyInstaller does not cross-build a real macOS `.app` from Windows because the app bundle contains a macOS bootloader and needs macOS signing/notarization tooling.

The app stores Mac user data in:

```text
~/Library/Application Support/AnimeCharacterMaker
```

## Download Website

Local test URL:

```text
http://127.0.0.1:8085/
```

Static site folder:

```text
site/
```

## iPhone PWA

The iPhone web app is in:

```text
site/iphone/
```

It uses a local canvas preview. Offline install/caching on iPhone requires serving the static site over HTTPS. The WebGPU/diffusion model runner is not enabled yet; a real phone-local diffusion build needs a tiny converted model and profiling on actual iPhone hardware.
