{"id":28439445,"url":"https://github.com/dojoengine/wordle-js","last_synced_at":"2026-02-05T08:02:35.095Z","repository":{"id":282210236,"uuid":"947389285","full_name":"dojoengine/wordle-js","owner":"dojoengine","description":"A simple wordle game to showcase and illustrate Dojo JS SDK usage.","archived":false,"fork":false,"pushed_at":"2025-03-13T15:36:42.000Z","size":217,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"feat/client-08","last_synced_at":"2025-07-23T04:44:16.086Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Cairo","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dojoengine.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,"zenodo":null}},"created_at":"2025-03-12T15:59:14.000Z","updated_at":"2025-03-13T10:22:26.000Z","dependencies_parsed_at":"2025-07-23T04:46:40.787Z","dependency_job_id":null,"html_url":"https://github.com/dojoengine/wordle-js","commit_stats":null,"previous_names":["dojoengine/wordle-js"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dojoengine/wordle-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dojoengine%2Fwordle-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dojoengine%2Fwordle-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dojoengine%2Fwordle-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dojoengine%2Fwordle-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dojoengine","download_url":"https://codeload.github.com/dojoengine/wordle-js/tar.gz/refs/heads/feat/client-08","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dojoengine%2Fwordle-js/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29116450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T05:31:32.482Z","status":"ssl_error","status_checked_at":"2026-02-05T05:31:29.075Z","response_time":65,"last_error":"SSL_read: 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":[],"created_at":"2025-06-06T02:39:46.799Z","updated_at":"2026-02-05T08:02:35.079Z","avatar_url":"https://github.com/dojoengine.png","language":"Cairo","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Onchain Wordle\n\nA decentralized implementation of the popular word-guessing game Wordle, built using Dojo and running entirely onchain.\n\n## Project Overview\n\nOnchain Wordle brings the addictive word-guessing game to the blockchain, allowing players to enjoy Wordle in a decentralized environment. The game logic is implemented as smart contracts using Dojo, with a client interface that interacts with these contracts through the dojo.js SDK.\n\n## Description\n\nWordle is a game where players attempt to guess a hidden five-letter word. After each guess, feedback is provided showing which letters are correct and in the right position (green), which letters are in the word but in the wrong position (yellow), and which letters are not in the word at all (gray).\n\nThis implementation takes the classic Wordle gameplay and brings it onchain, demonstrating how traditional games can be reimagined in a Web3 context. The entire game state and logic is stored and executed on the blockchain, providing transparency and immutability to the gameplay experience.\n\n## Installation\n\n### Prerequisites\n- Node.js (v16+)\n- pnpm\n- Git\n- [Dojo toolkit](https://book.dojoengine.org/getting-started/quick-start.html)\n- Docker \u0026 Docker compose\n\n### Setup\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/dojoengine/wordle-js.git\n   cd wordle-js\n   ```\n\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n3. Start docker\n   ```bash\n   docker compose up\n   ```\n\n4. Run the development server:\n   ```bash\n   pnpm dev\n   ```\n\n5. Visit `http://localhost:5173` in your browser to play the game.\n\n## Client Development Journey\n\nThis project was built incrementally, with each step focusing on a specific aspect of the client development. You can explore this journey by checking out the different feature branches:\n\n### Branch Structure\n\n- `main` - Contains the core Dojo contracts that power the game\n- `feat/client-00` to `feat/client-08` - Progressive implementation of the client features\n\n### Client Steps\n\nEach feature branch contains a `STEP-xx.md` file that explains the changes implemented in that branch. Here's a summary of what each step covers:\n\n1. **feat/client-00**: Basic project setup and initialization with dojo.js\n2. **feat/client-01**: Creating the game board UI components\n3. **feat/client-02**: Implementing keyboard input handling\n4. **feat/client-03**: Adding game state management\n5. **feat/client-04**: Connecting to the Dojo contracts\n6. **feat/client-05**: Implementing guess submission and validation\n7. **feat/client-06**: Adding visual feedback for guesses\n8. **feat/client-07**: Game completion and restart functionality\n9. **feat/client-08**: Final polish and optimizations\n\nTo explore a specific development step, checkout the corresponding branch:\n```bash\ngit checkout feat/client-xx\n```\n\nThen read the `STEP-xx.md` file to understand the changes implemented in that step.\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 file for details.\n\n---\n\nBuilt with ❤️ using [Dojo](https://dojoengine.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdojoengine%2Fwordle-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdojoengine%2Fwordle-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdojoengine%2Fwordle-js/lists"}