arcnaboo/football-legends — explained in plain English
Analysis updated 2026-05-18
Play a football-themed card game against an AI manager on mobile or web.
Build and save a 30-card deck using players, tactics, and formations.
Study the project as an example of a full-stack Expo plus FastAPI game built through vibe coding.
| arcnaboo/football-legends | 0xkinno/astraea | 0xkinno/halcyon | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | hard | hard |
| Complexity | 3/5 | 4/5 | 4/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Node.js, Yarn, Python, and a running MongoDB instance for both frontend and backend.
Football Legends CCG is a collectible card game modeled on Hearthstone but re themed around football. Instead of minions you deploy players like strikers, wingers, and goalkeepers onto the pitch, and instead of a hero you control a manager who starts with 30 health. You play tactic cards such as counter attacks and penalties, pick a formation, and spend match energy each turn to reduce your opponent's manager health to zero before they do the same to you. Right now it is single player against a rule based AI opponent. Matches are worked out by a deterministic game engine running on the server, while decks are saved locally on the device. The card pool includes 35 player cards ranging from common to legendary, 5 managers each with their own passive ability and hero power, 15 tactic cards, and 4 formation cards. Player names are fictional, styled the way some football games rename real players, to avoid licensing problems. The app covers a main menu, a match board with the pitch, hand, and mana bar, a deck builder for assembling 30 card decks, and a collection screen to browse all 54 cards. The frontend is built with Expo, React Native, TypeScript, and Expo Router, and can run on iOS, Android, or as a web preview. The backend is a FastAPI server in Python with a separate game engine module and a card database module, and it stores data in MongoDB. To run it locally you need Node.js 18 or newer with Yarn for the frontend, Python 3.10 or newer for the backend, and a MongoDB instance. You set up a Python virtual environment, install backend dependencies, and start the API server with uvicorn, then install frontend dependencies with yarn and run the Expo development server, pointing the frontend at the backend's URL. The project describes itself as an early version built through vibe coding, with a roadmap that includes online multiplayer, card packs and progression, licensed artwork, and manager campaigns. It is a hobby project rather than a finished product, and the README notes it is not affiliated with any real football players, clubs, or leagues.
Football Legends CCG is a Hearthstone-style collectible card game re-themed around football, playable single-player against an AI opponent.
Mainly TypeScript. The stack also includes TypeScript, React Native, Expo.
No license information is provided in the README.
Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.