{"id":24409182,"url":"https://github.com/steellgold/blackjack","last_synced_at":"2026-02-13T04:31:42.017Z","repository":{"id":269173246,"uuid":"906626142","full_name":"Steellgold/blackjack","owner":"Steellgold","description":"🃏 A blackjack game with NextJS and Socket.IO","archived":false,"fork":false,"pushed_at":"2025-01-06T07:53:35.000Z","size":406,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"stable","last_synced_at":"2025-04-23T11:57:43.917Z","etag":null,"topics":["blackjack","card-game","monorepo","nextjs","socket"],"latest_commit_sha":null,"homepage":"https://blackjack.steellgold.fr/","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/Steellgold.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-12-21T12:40:09.000Z","updated_at":"2025-02-06T14:51:44.000Z","dependencies_parsed_at":"2024-12-21T14:24:44.330Z","dependency_job_id":"7a089d24-6182-462c-ab19-1050232b85a8","html_url":"https://github.com/Steellgold/blackjack","commit_stats":null,"previous_names":["steellgold/blackjack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steellgold%2Fblackjack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steellgold%2Fblackjack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steellgold%2Fblackjack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steellgold%2Fblackjack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Steellgold","download_url":"https://codeload.github.com/Steellgold/blackjack/tar.gz/refs/heads/stable","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250430589,"owners_count":21429323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["blackjack","card-game","monorepo","nextjs","socket"],"created_at":"2025-01-20T05:55:08.908Z","updated_at":"2026-02-13T04:31:36.996Z","avatar_url":"https://github.com/Steellgold.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎰 Blackjack\n\nA modern multiplayer Blackjack game built with Next.js, Socket.IO, and TypeScript. Play against the dealer or with friends in real-time!\n\n## ✨ Features\n\n- 🎮 Single-player and multiplayer modes\n- 🌐 Real-time gameplay with WebSocket\n- 💬 In-game chat system\n- 🎨 Multiple table themes\n- 🌍 Internationalization (English/French)\n- 📱 Responsive design (Mobile, Tablet, Desktop)\n- 🎲 Realistic card dealing animations\n- 💰 Betting system with chips\n- 🎯 Standard Blackjack rules implementation\n- 👥 Support for up to 7 players per table\n\n## 🛠️ Tech Stack\n\n- **Frontend:**\n  - Next.js 15\n  - React 19\n  - TypeScript\n  - Tailwind CSS\n  - shadcn/ui\n  - Socket.IO Client\n  - Zustand (State Management)\n  - Framer Motion (Animations)\n\n- **Backend:**\n  - Socket.IO\n  - Fastify\n  - TypeScript\n\n## 📁 Project Structure\n\n```\napps/\n├── socket/      # Socket.IO backend server\n└── www/         # Next.js frontend application\npackages/\n├── game/        # Shared game logic and types\n└── db/          # Database integration (Supabase) - Not used for now\n```\n\n## 🚀 Getting Started\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/Steellgold/blackjack.git\ncd blackjack\n```\n\n2. Install dependencies:\n```bash\npnpm install\n```\n\n3. Create a `.env` file in the `packages/www` directory:\n```env\nNEXT_PUBLIC_SOCKET_URL=\"http://localhost:3001/\"\n```\n\n4. Start the development servers:\n```bash\npnpm dev\n```\n\n5. Open `http://localhost:3000` in your browser to play!\n\n## 🎮 Game Rules\n\n- Each player starts with a defined balance\n- Players can bet using various chip denominations\n- The goal is to beat the dealer's hand without going over 21\n- Players can \"Hit\" (take another card) or \"Stand\" (keep current hand)\n- Dealer must hit on 16 and stand on 17\n- Blackjack (Ace + 10-value card) pays 2.5x the bet\n- Regular wins pay 2x the bet\n- Push (tie) returns the original bet\n\n## 🌟 Features in Detail\n\n### 🎲 Real-time Multiplayer\n- Create private tables\n- Join existing tables using table codes\n- Watch other players' moves in real-time\n- Synchronize game states across all players\n\n### 💬 Chat System\n- Real-time chat with other players at the table\n- Unread message notifications\n- Player name and timestamp for each message\n\n### 🎨 Theme System\n- Multiple table themes (Classic, Sky, Modern, Neon, Darkness)\n- Theme persistence across sessions\n- Smooth theme transitions\n\n### 🌍 Internationalization\n- English and French language support\n- Persistent language selection\n- Complete translation coverage\n\n### 💰 Betting System\n- Multiple chip denominations\n- Visual chip stacking\n- Bet placement animations\n- Balance management\n\n### 📱 Responsive Design\n- Optimized for mobile devices\n- Tablet support\n- Desktop-first experience\n- Adaptive layouts\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteellgold%2Fblackjack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteellgold%2Fblackjack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteellgold%2Fblackjack/lists"}