docs: add README

Author: timkicker

README.md

@@ -0,0 +1,131 @@
+<p align="center">
+  <img alt="CupStore" src="meta/branding/cupstore_banner_with_logo_large.png" width="480">
+</p>
+
+<p align="center">
+  <b>A mod manager for the Wii U. Browse, install and manage SDCafiine mods.</b>
+</p>
+
+<p align="center">
+  <a href="https://github.com/timkicker/cupstore/actions">
+    <img alt="Build" src="https://img.shields.io/github/actions/workflow/status/timkicker/cupstore/release.yml?label=build">
+  </a>
+  <a href="https://github.com/timkicker/cupstore/releases/latest">
+    <img alt="Release" src="https://img.shields.io/github/v/release/timkicker/cupstore?display_name=tag&sort=semver">
+  </a>
+  <a href="LICENSE">
+    <img alt="License" src="https://img.shields.io/badge/license-GPLv3-blue.svg">
+  </a>
+  <img alt="Platform" src="https://img.shields.io/badge/platform-Wii%20U-lightgrey">
+</p>
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="meta/branding/screenshots/browse.png" alt="Browse mods" width="48%"/>
+  <img src="meta/branding/screenshots/detail.png" alt="Mod details" width="48%"/>
+</p>
+<p align="center">
+  <img src="meta/branding/screenshots/installed.png" alt="Installed mods" width="70%"/>
+</p>
+
+---
+
+## Features
+
+- Browse and install mods from community-hosted repositories
+- Per-game mod list with icons, tags, and metadata
+- Download queue with progress and error recovery
+- Activate / deactivate mods without uninstalling
+- Conflict detection between active mods
+- Update badges when newer versions are available
+- Settings tab with repo management, cache control, and log viewer
+
+---
+
+## Installation
+
+### Requirements
+- Wii U with [Aroma](https://aroma.foryour.cafe/) installed
+- SD card
+
+### Steps
+
+1. Download `wiiu_mod_store.wuhb` from the [latest release](https://github.com/timkicker/cupstore/releases/latest)
+2. Copy it to `SD:/wiiu/apps/cupstore/wiiu_mod_store.wuhb`
+3. Create `SD:/wiiu/apps/cupstore/config.json` with the repos you want to use:
+
+```json
+{
+  "repos": [
+    "https://raw.githubusercontent.com/your-name/your-repo/main/repo.json"
+  ]
+}
+```
+
+4. Launch CupStore via the Homebrew Launcher
+
+> **Note:** CupStore does not come with a built-in mod repository. You need to provide your own repo URL. See [Hosting your own repo](#hosting-your-own-repo) below.
+
+---
+
+## Hosting your own repo
+
+CupStore loads mods from community-hosted repositories. To host your own:
+
+1. Fork [cupstore-repo-template](https://github.com/timkicker/cupstore-repo-template)
+2. Add your games and mods following the schema in the template README
+3. Point your `config.json` at your fork's raw `repo.json` URL
+
+The template includes a validation script and GitHub Action that checks your repo on every PR.
+
+---
+
+## config.json Reference
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `repos` | ✅ | List of repo URLs to load mods from |
+
+```json
+{
+  "repos": [
+    "https://raw.githubusercontent.com/your-name/your-repo/main/repo.json",
+    "https://raw.githubusercontent.com/someone-else/their-repo/main/repo.json"
+  ]
+}
+```
+
+Multiple repos are supported and merged at runtime.
+
+---
+
+## Contributing
+
+PRs are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
+
+Branch strategy: `dev` is active development, `main` is stable/released. PRs go to `dev`.
+
+Tests run without devkitPro:
+```bash
+cd tests && mkdir -p build && cd build
+cmake .. && make && ./cupstore_tests
+```
+
+---
+
+## License & Credits
+
+Licensed under [GPLv3](LICENSE).
+
+**Libraries**
+- [devkitPro / WUT](https://devkitpro.org/) — Wii U toolchain and runtime
+- [SDL2](https://libsdl.org/) — rendering, input
+- [SDL2_ttf](https://github.com/libsdl-org/SDL_ttf) — font rendering
+- [SDL2_image](https://github.com/libsdl-org/SDL_image) — image loading
+- [libcurl](https://curl.se/libcurl/) — HTTP downloads
+- [nlohmann/json](https://github.com/nlohmann/json) — JSON parsing
+- [mbedTLS](https://github.com/Mbed-TLS/mbedtls) — TLS for HTTPS
+- [Catch2](https://github.com/catchorg/Catch2) — unit testing