{"id":13632295,"url":"https://github.com/aod/zhithead","last_synced_at":"2026-03-05T12:31:49.923Z","repository":{"id":60181265,"uuid":"502889715","full_name":"aod/zhithead","owner":"aod","description":"Zhithead is a clone of the original card game shithead made for the browser","archived":false,"fork":false,"pushed_at":"2025-01-18T22:07:06.000Z","size":5766,"stargazers_count":175,"open_issues_count":5,"forks_count":17,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-24T19:04:35.857Z","etag":null,"topics":["card-game","framer-motion","hacktoberfest","motion","react","shithead","tailwindcss","vite","xstate"],"latest_commit_sha":null,"homepage":"https://zhithead.yatko.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aod.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-13T09:27:54.000Z","updated_at":"2025-05-16T08:05:21.000Z","dependencies_parsed_at":"2025-02-22T17:38:58.579Z","dependency_job_id":null,"html_url":"https://github.com/aod/zhithead","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aod/zhithead","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aod%2Fzhithead","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aod%2Fzhithead/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aod%2Fzhithead/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aod%2Fzhithead/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aod","download_url":"https://codeload.github.com/aod/zhithead/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aod%2Fzhithead/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30124442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T11:11:57.947Z","status":"ssl_error","status_checked_at":"2026-03-05T11:11:29.001Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["card-game","framer-motion","hacktoberfest","motion","react","shithead","tailwindcss","vite","xstate"],"created_at":"2024-08-01T22:02:59.170Z","updated_at":"2026-03-05T12:31:49.883Z","avatar_url":"https://github.com/aod.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"[shithead]: https://en.wikipedia.org/wiki/Shithead_(card_game)\n[zhithead]: https://zhithead.yatko.dev\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://zhithead.yatko.dev\"\u003e\n    \u003cimg src=\"public/logo/zhithead.svg\" height=\"210\"\u003e\n    \u003ch1 align=\"center\"\u003e\u003cb\u003eZhithead\u003c/b\u003e\u003c/h1\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n[Rules](#rules)\n| [Background and motivation](#background-and-motivation)\n| [Roadmap](#roadmap)\n| [Development](#development)\n| [Contributing](#contributing)\n| [License](#license)\n\n![GitHub](https://img.shields.io/github/license/aod/zhithead?style=flat-square)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/aod/zhithead?style=flat-square)\n![GitHub Repo stars](https://img.shields.io/github/stars/aod/zhithead?style=social)\n\n---\n\n_**Disclaimer: Zhithead is currently a work in progress!**_\n\n---\n\nZhithead is a clone of the original card game [shithead][shithead] made for\nthe browser.\n\n\u003e Shithead (also known by many other names, most commonly Karma, Palace and\n\u003e Shed) is a card game, the object of which is to lose all of one's playing\n\u003e cards, with the final player being the \"shthead\".\n\nHere's a preview:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\".readme/preview.gif\" height=\"600\" /\u003e\n\u003c/p\u003e\n\nPlaytest it [here][zhithead]!\n\n## Rules\n\nOf course to playtest the game you need to know the rules. Well, here they are:\n\n- From a standard shuffled deck each player is dealt:\n  - 3 **hand** cards\n  - 3 **face-up** cards\n  - 3 **face-down** (blind) cards\n- At the beginning players place 3 cards from their **hand** as their **face-up**\n  cards\n- The cards are valued by **rank**:\n  - From lowest to highest value: 2, 3, 4, 5, 6, 7, 8, 9, 10, J, Q, K, A\n  - Played cards must be of equal or higher value\n  - 2, 7, 8 and 10 are special:\n    - 2: Can be played on anything\n    - 7: Any following card must be of equal or lesser value\n    - 8: Can be played on anything **and** is transparent\n    - 10: Burns the pile including itself\n- The game starts with the first turn being the next clockwise player of who\n  dealt the cards. Further turns are taken in clockwise order\n- Player does one of the following on their turn:\n  - Plays 1 up to multiple cards of the same rank\n  - Picks up the pile\n- Player then ensures their **hand** size is atleast 3 by picking card(s)\n  from the deck if necessary and is possible (deck contains cards)\n- When the player's _*hand*_ is empty you move to the next one:\n  **hand** -\u003e **face-up** -\u003e **face-down**\n- **face-down** cards are played _blindly_ and player must take the pile\n  onto their **hand** if its _value_ is less\n- First one to play their last card wins\n- Whoever wins is the next dealer\n\n# Background and motivation\n\nI never really got into card games until a good friend of mine introduced\nme to different kinds i.e. _Toepen_, _Eenendertigen_ and _Shithead_. This\nintrigued me to recreate them for in a browser. My first attempt precedes this\none which was the same card game, Shithead, but it was mainly focused on online\nsupport to play with friends. Long story short it worked quite well but the\ncodebase was such a mess and it didn't look great at all. Fastforward now I'm\nrecreating it but with the focus on UX first and multiplayer last.\n\n# Roadmap\n\nAs mentioned above in the disclaimer, Zhithead is still a work in progress and\nis missing some features. In the following stages of development I'm planning\nto implement the following features:\n\n## Alpha\n\n- [x] Implement missing rules\n  - [x] Burn pile after 4 cards with same rank has been played\n  - [x] Play multiple cards of the same rank\n- [x] Pile burn animation/UX\n- [x] Final win/lose page\n- [x] Simple title screen with basic info (about, source code, etc.) and a start button\n- [ ] Teach the player on how to play\n- [ ] ...\n\n## Beta\n\n- [ ] Multiplayer support upto 4 players\n  - [ ] Invite link\n- [ ] ...\n\n## Release\n\n- [ ] Rule variations\n- [ ] User profiles\n- [ ] Matchmaking\n- [ ] Leaderbords\n- [ ] ...\n\n# Development\n\nTo develop Zhithead you will first need to install\n[NodeJS](https://nodejs.org/en/download/).\n\nNext, download the source code and run the following commands in the root\ndirectory of the project:\n\n1. Install dependencies:\n   ```\n   npm install\n   ```\n2. Start dev environment:\n   ```\n   npm run dev\n   ```\n3. Visit [localhost:3000](http://localhost:3000) to view the application.\n\n## Building\n\nRunning this command will typecheck, lint and output the build files to `/dist`:\n\n```\nnpm run build\n```\n\n## Testing\n\nCurrently there are not a lot of tests but you can run what's there using:\n\n```\nnpm test\n```\n\n## Typecheck\n\nI like to run the following command to watch for changes and typecheck\nthe project:\n\n```\nnpx tsc --noEmit -w\n```\n\n# Contributing\n\nBug reports and fixes are appreciated as well as ideas or discussions!\n\nHowever, since this project is a work in progress, please refrain from making PRs\nimplementing features on the [roadmap](#roadmap).\n\nThanks for your comprehension.\n\n# License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faod%2Fzhithead","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faod%2Fzhithead","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faod%2Fzhithead/lists"}