{"id":48694978,"url":"https://github.com/w3rr0/pokerchips","last_synced_at":"2026-04-11T07:13:03.714Z","repository":{"id":282304813,"uuid":"948113746","full_name":"w3rr0/pokerchips","owner":"w3rr0","description":"Pokerchip$ is an application that allows you to play poker without physical chips. Thanks to it, players can simulate their chips in real time, which allows for comfortable gameplay even when they do not have traditional poker accessories with them. The perfect solution for playing on the go when taking a poker set would be a big problem.","archived":false,"fork":false,"pushed_at":"2026-03-10T10:17:39.000Z","size":3122,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-10T17:40:42.913Z","etag":null,"topics":["fastapi","game","poker","poker-chips","react","real-time","simulation"],"latest_commit_sha":null,"homepage":"https://www.poker-chips.tech","language":"JavaScript","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/w3rr0.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-13T19:16:34.000Z","updated_at":"2026-03-10T10:17:43.000Z","dependencies_parsed_at":"2025-04-07T18:29:26.121Z","dependency_job_id":"ac31372e-41cc-41d2-b2ca-1f1445c90caf","html_url":"https://github.com/w3rr0/pokerchips","commit_stats":null,"previous_names":["w3rr0/poker-chips-api","w3rr0/pokerchips"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/w3rr0/pokerchips","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3rr0%2Fpokerchips","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3rr0%2Fpokerchips/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3rr0%2Fpokerchips/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3rr0%2Fpokerchips/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/w3rr0","download_url":"https://codeload.github.com/w3rr0/pokerchips/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/w3rr0%2Fpokerchips/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31671979,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T17:19:37.612Z","status":"online","status_checked_at":"2026-04-11T02:00:05.776Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["fastapi","game","poker","poker-chips","react","real-time","simulation"],"created_at":"2026-04-11T07:13:03.054Z","updated_at":"2026-04-11T07:13:03.706Z","avatar_url":"https://github.com/w3rr0.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![project_license][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/w3rr0/pokerchips\"\u003e\n    \u003cimg src=\"front/public/pokerchips.png\" alt=\"Logo\" height=\"100\"\u003e\n  \u003c/a\u003e\n\n  \u003cp align=\"center\"\u003e\n    Pokerchip$ is an application that allows you to play poker without physical chips.\n    Thanks to it, players can simulate their chips in real time,\n    which allows for comfortable gameplay even when they do not have traditional poker accessories with them.\n    The perfect solution for playing on the go when taking a poker set would be a big problem.\n    \u003cbr /\u003e\n    \u003ca href=\"https://www.poker-chips.tech\"\u003e\u003cstrong\u003eTry Yourself »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003c!-- \u003ca href=\"https://github.com/w3rr0/pokerchips\"\u003eView Demo\u003c/a\u003e\n    \u0026middot; --\u003e\n    \u003ca href=\"https://github.com/w3rr0/pokerchips/issues/new?labels=bug\u0026template=bug-report---.md\"\u003eReport Bug\u003c/a\u003e\n    \u0026middot;\n    \u003ca href=\"https://github.com/w3rr0/pokerchips/issues/new?labels=enhancement\u0026template=feature-request---.md\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#for-who\"\u003eFor Who\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#why-pokerchip\"\u003eWhy Pokerchip$\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#background\"\u003eBackground\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#whats-next\"\u003eWhat's Next\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#design\"\u003eDesign\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\n          \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n          \u003cul\u003e\n            \u003cli\u003e\u003ca href=\"#git\"\u003eGit\u003c/a\u003e\u003c/li\u003e\n            \u003cli\u003e\u003ca href=\"#frontend\"\u003eFrontend\u003c/a\u003e\u003c/li\u003e\n            \u003cli\u003e\u003ca href=\"#backend\"\u003eBackend\u003c/a\u003e\u003c/li\u003e\n            \u003cli\u003e\u003ca href=\"#startup\"\u003eStartup\u003c/a\u003e\u003c/li\u003e\n          \u003c/ul\u003e\n          \u003cli\u003e\u003ca href=\"#tests\"\u003eTests\u003c/a\u003e\u003c/li\u003e\n        \u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#home\"\u003eHome\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#join\"\u003eJoin\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#create\"\u003eCreate\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#gameplay\"\u003eGameplay\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n# About The Project\n\n### For who\n\nFor all those who, whether away or at home,\nwant to play poker with friends but do not have a poker set with them.\nNow all you need to play is cards.\n\n### Why pokerchip$\n\nIt's simple! Pokerchip$ is easy to understand, free, and gives you full control over your chips.\nIt doesn't restrict your style of play in any way.\nYou can play by your own rules, and the chip system won't limit you.\n\n### Background\n\nThe idea was born when I noticed that on many trips with friends we wanted to play poker,\nbut we almost never took poker accessories.\nSomeone always had cards, and they were not a problem,\nand playing online is not the same as playing live, so pokerchip$ was perfect for such situations.\n\n### What's next\n\nI've already added all the key things that I thought were necessary for the app to work well. However, if new plans appear, I'll be introducing them on an ongoing basis.\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n## Built With\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"assets/icons/FastAPI.svg\" height=\"64\" alt=\"fastapi\"\u003e\n    \u003cimg src=\"assets/icons/React.svg\" height=\"64\" alt=\"react\"\u003e\n    \u003cimg src=\"assets/icons/Azure.svg\" height=\"64\" alt=\"azure\"\u003e\n\u003c/p\u003e\n\n- Backend\n  - FastAPI 0.115\n  - Python 3.12\n- Frontend\n  - React 19\n- Server\n  - Azure App Service\n  - Azure Static Web App\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### Design\n\nHere's a design sample from the current version of the app:\n\n\u003cdiv style=\"display: flex; gap: 15px\" align=\"center\"\u003e\n    \u003cimg src=\"assets/screenshots/Home-mobile.png\" alt=\"home-mobile\" height=\"400\"\u003e\n    \u003cimg src=\"assets/screenshots/Create-mobile.png\" alt=\"create-mobile\" height=\"400\"\u003e\n    \u003cimg src=\"assets/screenshots/Join-mobile.png\" alt=\"join-mobile\" height=\"400\"\u003e\n\u003c/div\u003e\n\n\u003cdiv style=\"display: flex; gap: 15px; margin-top: 25px;\" align=\"center\"\u003e\n    \u003cimg src=\"assets/screenshots/Gameplay-mobile.png\" alt=\"gameplay-mobile\" height=\"400\"\u003e\n    \u003cimg src=\"assets/screenshots/Gameplay-tablet.png\" alt=\"gameplay-tablet\" height=\"400\"\u003e\n\u003c/div\u003e\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nThis is an example of how you may give instructions on setting up your project locally.\nTo get a local copy up and running, follow these simple example steps.\n\n### Prerequisites\n\nThis is an example of how to list things you need to use the software and how to install them.\n\n* Python\n\n    check if you have the required version of python installed\n\n    ```sh\n    python3.12 --version\n    ```\n\n    if you don't have it installed, download it from the official website: [python.org](https://www.python.org/downloads/) (or other preferred source)\n\n* npm\n  ```sh\n  npm install npm@latest -g\n  ```\n  or if you don't have npm installed, download it from: [nodejs.org](https://nodejs.org)\n\n\n* pip\n    ```sh\n    pip install --upgrade pip\n    ```\n\n## Installation\n\n#### Git:\n\n1. Clone the repo\n   ```sh\n   git clone https://github.com/w3rr0/pokerchips.git\n   ```\n   or fork this repo to your account and clone it from there\n   \n\n2. Change git remote url to avoid accidental pushes to a base project\n   ```sh\n   git remote set-url origin git remote set-url origin https://github.com/github_username/repo_name.git\n   git remote -v # confirm the changes\n   ```\n\n#### Frontend:\n\n3. Go to the front directory\n    ```sh\n    cd front\n    ```\n   \n4. create environment\n\n    **Linux**/**Mac**:\n    ```sh\n    echo -e \"VITE_API_URL=http://localhost:8000\\nVITE_WS_URL=ws://localhost:8000/ws\\nVITE_GITHUB_LINK=https://github.com/w3rr0/pokerchips\" \u003e .env.development\n    ```\n   **Windows**:\n    ```sh\n    echo VITE_API_URL=http://localhost:8000 \u003e .env.development\n    echo VITE_WS_URL=ws://localhost:8000/ws \u003e\u003e .env.development\n    echo VITE_GITHUB_LINK=https://github.com/w3rr0/pokerchips \u003e\u003e .env.development\n    ```\n   or if necessary, replace the values with yours\n\n\n5. Install NPM packages\n   ```sh\n   npm install --legacy-peer-deps\n   ```\n   \n#### Backend:\n\n6. Go back to root\n    ```sh\n    cd ..\n    ```\n   \n7. Create virtual env\n    ```sh\n    python3.12 -m venv .venv\n    ```\n   \n8. Activate virtual env\n\n    **Linux**/**Mac**:\n\n    ```sh\n    source .venv/bin/activate\n    ```\n   \n    **Windows**\n    ```sh\n    .venv\\Scripts\\activate\n    ```\n   \n9. go to the backend directory\n    ```sh\n    cd backend\n    ```\n\n10. Install dependencies\n    ```sh\n    pip3 install -r requirements.txt\n    ```\n11. create env\n     **Linux**/**Mac**:\n     ```sh\n     echo -e \"ALLOW_CREDENTIALS=True\\nALLOWED_ORIGINS=http://localhost:5173\" \u003e .env\n     ```\n   \n    **Windows**:\n    ```sh\n    echo ALLOW_CREDENTIALS=True \u003e .env \u0026\u0026 echo ALLOWED_ORIGINS=http://localhost:5173 \u003e\u003e .env\n    ```\n   \n    or change values if u need to\n\n\n#### Startup\n\n12. Open root in a new terminal window and start the backend server\n    ```sh\n    uvicorn backend.main:app --reload\n    ```\n\n13. Repeat this action but with the frontend\n    ```sh\n    cd front\n    npm run dev\n    ```\n\n14. Go to the URL you get this way, and you're done!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Tests\n\nTo make sure everything on the backend has been set up correctly, you can run tests\n\nIn the new terminal (with an active virtual environment):\n```sh\npytest backend/tests/test_app.py\n```\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n# Usage\n\n### Home\n\nTo start the game, you have two options, either to join a friend's room or create your own.\nEnter your nickname (between 1 and 15 characters) and select one of these options by clicking the appropriate button.\n\n### Join\n\nWhen joining, you must enter the PIN of the room you want to join and choose your starting token value (from 0 to 10,000,\nthe default is 2,500). Once you do this, confirm with the button, and you will be transferred to the game\n\n### Create\n\nIf you are the one creating the room, you also have to choose your starting value of your tokens and the maximum number of players that can play at the same time\n(from 2 to 9, but if you don't care about the limit, I recommend leaving it at 9, you never know if someone will want to join you 😉)\n\n### Gameplay\n\nOnce you join a room, you will see all the information about the room such as:\n\n- PIN\n- Current number of players\n- Player limit in room\n\nA table that simulates the one during live play, containing:\n\n- At the bottom\n  - your avatar with information about the current value of all tokens\n  - tokens corresponding to the amount you selected\n- In the middle\n  - the amount currently placed on the table by all players\n  - the value of the bet you are currently placing\n- At the top\n  - avatars of the rest of the players along with the amount they have (If you are alone in the room, a message will be displayed that there are no other players)\n\nAn additional section for controlling the game where you will find:\n\n- control buttons\n  - collecting your chips from the table\n  - collecting the winnings, i.e., all the chips on the table\n  - leaving the room\n- an additional chat section (if you are using a device with a large enough screen, such as a PC, laptop, or some tablets), where you will find:\n  - messages sent by other users since you joined the room\n  - gameplay history, from which you can learn about who:\n    - join\n    - left\n    - win (and how much)\n\nTo place a bet, simply click on a chip with the appropriate value.\n\nAll events are updated continuously for each player without the need to refresh the page.\n\nFor a more detailed explanation of how everything works under the hood,\nplease visit the documentation for the individual functions found in the project source files.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- CONTRIBUTING --\u003e\n# Contributing\n\nAny contributions you make are **greatly appreciated**!\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!--\n## Top contributors:\n\n\u003ca href=\"https://github.com/w3rr0/pokerchips/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=w3rr0/pokerchips\" alt=\"contrib.rocks image\" /\u003e\n\u003c/a\u003e\n\n--\u003e\n\n\n\u003c!-- LICENSE --\u003e\n# License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTACT --\u003e\n# Contact\n\nLinkedin: [Konrad Mateja][linkedin-url]\n\nProject Link: [https://github.com/w3rr0/pokerchips](https://github.com/w3rr0/pokerchips)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[stars-shield]: https://img.shields.io/github/stars/w3rr0/pokerchips.svg?style=for-the-badge\n[stars-url]: https://github.com/w3rr0/pokerchips/stargazers\n[issues-shield]: https://img.shields.io/github/issues/w3rr0/pokerchips.svg?style=for-the-badge\n[issues-url]: https://github.com/w3rr0/pokerchips/issues\n[license-shield]: https://img.shields.io/github/license/w3rr0/pokerchips.svg?style=for-the-badge\n[license-url]: https://github.com/w3rr0/pokerchips/blob/main/LICENSE\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/konrad-mateja-00bbbb335\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fw3rr0%2Fpokerchips","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fw3rr0%2Fpokerchips","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fw3rr0%2Fpokerchips/lists"}