https://github.com/johnameyer/cards-ts

A card game framework and various games in Typescript. The framework allows for bot development and playing card games in the terminal or in a browser.
https://github.com/johnameyer/cards-ts

card-game card-games cards framework game-engine games javascript turn-based typescript typescript-library

Last synced: 5 days ago
JSON representation

A card game framework and various games in Typescript. The framework allows for bot development and playing card games in the terminal or in a browser.

• Host: GitHub
• URL: https://github.com/johnameyer/cards-ts
• Owner: johnameyer
• License: mit
• Created: 2019-04-23T23:05:28.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2026-04-20T02:45:08.000Z (4 months ago)
• Last Synced: 2026-04-20T04:41:39.340Z (4 months ago)
• Topics: card-game, card-games, cards, framework, game-engine, games, javascript, turn-based, typescript, typescript-library
• Language: TypeScript
• Homepage: https://johnmeyer.dev/cards-ts/
• Size: 2.27 MB
• Stars: 15
• Watchers: 1
• Forks: 2
• Open Issues: 49
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
Cards-TS



[![Github CI](https://img.shields.io/github/actions/workflow/status/johnameyer/cards-ts/ci.yml?logo=github)](https://github.com/johnameyer/cards-ts/actions)

[![npm version](https://img.shields.io/npm/v/@cards-ts/core?logo=npm)](https://www.npmjs.com/package/@cards-ts/core)

[![GitHub Last Commit](https://img.shields.io/github/last-commit/johnameyer/cards-ts?logo=github)](https://github.com/johnameyer/cards-ts)

[![Typescript](https://img.shields.io/github/languages/top/johnameyer/cards-ts?logo=typescript)]()

[![Documentation](https://img.shields.io/static/v1?label=docs&message=hosted&color=informational&logo=typescript)](https://johnameyer.github.io/cards-ts)



This is a card game framework and various card game implementations. The [core package](https://github.com/johnameyer/cards-ts/tree/master/src/core) contains the framework and useful components, including functionality to display a card game in the command line. The various other packages are card game implementations.

Can I Have That is a house variation on [Continental Rummy](https://en.wikipedia.org/wiki/Continental_Rummy).

[Hearts](https://en.wikipedia.org/wiki/Hearts_(card_game)) and [Euchre](https://en.wikipedia.org/wiki/Euchre) are trick-taking games.

Other implementations of card games or expansions of the core library are welcome.

## Running a card game with npx

```bash

npx @cards-ts/hearts # or can-i-have-that, etc.

```

## Implementing a new card game

See the [wiki page](./wiki/implementing-new-games.md).

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/johnameyer/cards-ts/tags).

## Authors

* **John Meyer** - *Initial work* - [johnameyer](https://github.com/johnameyer)

See also the list of [contributors](https://github.com/johnameyer/cards-ts/contributors) who participated in this project.