shogo-demo-flatpak/flathub-submission/README-SUBMISSION.md

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

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