# Flathub submission — Shogo: Mobile Armor Division (Linux Demo)

This folder contains everything needed to submit the app to Flathub.

## Files

- `io.github.enne2.ShogoDemo.yml` — Flatpak manifest (multiarch i386, sdl12-compat, gamescope)
- `flathub.json` — restrict builds to x86_64
- `shogo-demo` — launcher wrapper (EULA dialog, gamescope, audio, saves)
- `eula-dialog.c` — GTK3 EULA acceptance dialog (C source, compiled in the manifest)
- `io.github.enne2.ShogoDemo.desktop`
- `io.github.enne2.ShogoDemo.metainfo.xml`
- `icon-256.png`

The demo game data (`shogo-demo-src.tar.gz`, 37 MB) is NOT in this folder: it is
fetched by the build from a public URL (see `io.github.enne2.ShogoDemo.yml`,
source `archive`).

## Prerequisites

1. A **GitHub account** (the app ID `io.github.enne2.ShogoDemo` requires the
   repository `github.com/enne2/shogo-demo-flatpak` to exist, or change the ID).
2. A **public URL** hosting `shogo-demo-src.tar.gz`
   (SHA256 `dd6b4438c8fa72f04ca74857d11ea9d250eb497720eef5e312523eae43116b9c`),
   e.g. `https://enne2.net/pub/shogo-demo-src.tar.gz`.

## Steps

1. **Host the data tarball** at a stable public URL and update
   `url:` in the `archive` source of `io.github.enne2.ShogoDemo.yml`.
2. **Create the GitHub repository** `enne2/shogo-demo-flatpak` (public) and
   push this folder (manifest, wrapper, sources, icons, README).
3. **Fork** `https://github.com/flathub/flathub` and create a branch from `new-pr`.
4. In the fork, create the folder `io.github.enne2.ShogoDemo/` and add:
   - `io.github.enne2.ShogoDemo.yml`
   - `flathub.json`
   - `shogo-demo` (wrapper)
   - `eula-dialog.c`
   - `io.github.enne2.ShogoDemo.desktop`
   - `io.github.enne2.ShogoDemo.metainfo.xml`
   - `icon-256.png` (installed as `io.github.enne2.ShogoDemo.png`)
5. Open a **Pull Request** against the `new-pr` branch with title
   `Add io.github.enne2.ShogoDemo`.
6. Flathub's bot will build the app. Reply to review comments and request a
   test build with `bot, build` when needed.

## Important notes

- **Flathub policy: manifest, metadata, patch files and PR comments must NOT be
  AI-generated.** Review/edit every file manually before submitting.
- **License**: the demo is shareware/proprietary (Monolith Productions /
  Hyperion Entertainment). No explicit redistribution EULA was found; the demo
  has been freely distributed historically (Open Pandora lists it as
  "Redistribute: Allowed"). There is a risk that Flathub rejects or removes the
  app. Use at your own discretion.
- `sdl12-compat` is fetched from the upstream Git tag `release-1.2.76` (fixed commit).

## Test locally

```sh
flatpak-builder --user --force-clean --repo=repo build io.github.enne2.ShogoDemo.yml
flatpak install --user -y repo io.github.enne2.ShogoDemo
flatpak run io.github.enne2.ShogoDemo
```