whatisgithub

What is football-legends?

arcnaboo/football-legends — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 3/5Setup · moderate

In one sentence

Football Legends CCG is a Hearthstone-style collectible card game re-themed around football, playable single-player against an AI opponent.

Mindmap

mindmap
  root((football-legends))
    What it does
      Card game vs AI
      Manager HP battle
      Deck building
      Card collection
    Tech stack
      Expo React Native
      TypeScript
      FastAPI
      MongoDB
    Use cases
      Single player matches
      Deck construction
      Full stack learning
    Status
      Early MVP
      Vibe coded
      Roadmap planned

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Play a football-themed card game against an AI manager on mobile or web.

USE CASE 2

Build and save a 30-card deck using players, tactics, and formations.

USE CASE 3

Study the project as an example of a full-stack Expo plus FastAPI game built through vibe coding.

What is it built with?

TypeScriptReact NativeExpoPythonFastAPIMongoDB

How does it compare?

arcnaboo/football-legends0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Node.js, Yarn, Python, and a running MongoDB instance for both frontend and backend.

No license information is provided in the README.

So what is it?

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.

Copy-paste prompts

Prompt 1
How do I set up the FastAPI backend and MongoDB for Football Legends CCG locally?
Prompt 2
Walk me through starting the Expo frontend and connecting it to the local backend.
Prompt 3
Explain how the deterministic game engine resolves a match turn in this project.
Prompt 4
What are the API endpoints for starting a match and playing a card in Football Legends CCG?

Frequently asked questions

What is football-legends?

Football Legends CCG is a Hearthstone-style collectible card game re-themed around football, playable single-player against an AI opponent.

What language is football-legends written in?

Mainly TypeScript. The stack also includes TypeScript, React Native, Expo.

What license does football-legends use?

No license information is provided in the README.

How hard is football-legends to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is football-legends for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.