Skip to content

docs(readme): product README with screenshots; developer docs move to docs/DEVELOPMENT.md - #167

Merged
dinooo13 merged 1 commit into
mainfrom
docs/product-readme
Sep 29, 2026
Merged

dinooo13 merged 1 commit into
mainfrom
docs/product-readme

Conversation

@dinooo13

@dinooo13 dinooo13 commented Sep 29, 2026 •

Copy link
Copy Markdown
Owner

Summary

Replaces the developer-oriented README with a product-focused one: what YGO Alpha does for a player, with dark-mode screenshots of every major feature. The existing technical content moves to docs/DEVELOPMENT.md.

Roadmap phase / item

Documentation, across phases 1–5 (it presents the features the roadmap has delivered so far).

Changes

  • New README.md: tagline, disclaimer at the top (ADR 0018), then feature sections with screenshots: inventory, quick entry, catalog, deck editor, formats and legality, assistant, tournaments, sharing and profiles, mobile/PWA. Ends with a short quick start (pnpm and Docker), the stack, doc links and credits (YGOPRODeck, ygoresources, ADR 0015).
  • docs/DEVELOPMENT.md: the previous README, with relative links fixed for its new location and a short intro. Its built-in format list now also names Classic Plus (ADR 0022). Nothing else is rewritten.
  • Rebased on #eaf55dc (invite code + admin token): main's README edits (NUXT_INVITE_CODE, NUXT_ADMIN_TOKEN, the token-based catalog sync, the public-host note) are carried over into docs/DEVELOPMENT.md. The new README's Docker quick start writes both to .env, because compose only reads variables other than the secret and URL from there, and loads the catalog with the admin token (ADR 0027 expects the README's deployment notes to mention the invite code).
  • docs/screenshots/*.webp: 8 desktop shots (1440×900 @2x, downscaled to 2000px) and 3 phone shots, about 1.5 MB total. Taken from a production build on a copy of the database, with a fresh demo account (@yugi) and made-up collection, decks, wishlist and tournament. No real user data appears.

Test plan

  • Every relative link and image path in README.md and docs/DEVELOPMENT.md resolves
  • Every feature claim checked against the running app or the code (removed one that wasn't true: adding missing deck cards to the wishlist)
  • Look over the rendered README on GitHub (WebP images, the three phone shots side by side)
  • CI gates pass (docs-only change)

🤖 Generated with Claude Code

… docs/DEVELOPMENT.md

The README now introduces YGO Alpha from a player's point of view: what
each feature does, with dark-mode screenshots of the inventory, quick entry,
catalog, deck editor, assistant, tournaments, public profile and the mobile
layout, followed by a short quick start, the stack, and credits.

The previous README moves unchanged to docs/DEVELOPMENT.md (links adjusted
for the new location) with a short intro; its built-in format list now names
Classic Plus (ADR 0022). The disclaimer stays at the top of the README
(ADR 0018) and the README keeps the YGOPRODeck and ygoresources credits
(ADR 0015).

Screenshots were taken from a demo account with made-up data, 2000px WebP
(~1.5 MB total).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@dinooo13
dinooo13 merged commit 3a47ff6 into main Sep 29, 2026
2 checks passed
@dinooo13
dinooo13 deleted the docs/product-readme branch September 29, 2026 19:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant