{"id":41641294,"url":"https://github.com/zetter/multicrosser","last_synced_at":"2026-01-24T15:10:42.250Z","repository":{"id":35122911,"uuid":"159533673","full_name":"zetter/multicrosser","owner":"zetter","description":"Multiplayer Crosswords","archived":false,"fork":false,"pushed_at":"2023-01-05T16:15:20.000Z","size":1305,"stargazers_count":16,"open_issues_count":30,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-10T22:02:11.358Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://multicrosser.chriszetter.com","language":"Ruby","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/zetter.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}},"created_at":"2018-11-28T16:41:32.000Z","updated_at":"2024-05-10T22:02:11.359Z","dependencies_parsed_at":"2023-01-15T14:30:42.675Z","dependency_job_id":null,"html_url":"https://github.com/zetter/multicrosser","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zetter/multicrosser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zetter%2Fmulticrosser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zetter%2Fmulticrosser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zetter%2Fmulticrosser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zetter%2Fmulticrosser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zetter","download_url":"https://codeload.github.com/zetter/multicrosser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zetter%2Fmulticrosser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28730315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"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":"2026-01-24T15:10:41.792Z","updated_at":"2026-01-24T15:10:42.242Z","avatar_url":"https://github.com/zetter.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multiplayer Crosswords with Multicrosser\n\nThis is a Rails Application that uses WebSockets and the [react-crossword](https://github.com/zetter/react-crossword) component to create multiplayer crosswords. You can [read a blog post about why I built it and how it works](https://chriszetter.com/blog/2018/12/02/multiplayer-crosswords/).\n\nYou can see a demo at [multicrosser.chriszetter.com](https://multicrosser.chriszetter.com).\n\n## Setup\n\nTo run this project:\n+ Install Redis and make sure the server is running\n+ Run `./bin/setup` to install dependencies\n+ Run `./bin/rails crosswords:load_from_feed` to load the latest crosswords to display on the homepage\n+ Run `./bin/rails server` to start the project\n\n## How it works\n\n### Sending a Move\n\nHere's what happens when a player types a character:\n\n1. Client: `react-crossword` calls `setCellValue` to update the grid\n  * `setCellValue` calls the `onMove` callback with cell location and value\n  * `onMove` callback calls the `move` function in the action cable subscription\n  * The `move` function sends the move to the server\n2. Server: `MovesChannel#move` is run\n  * The move is recorded in Redis\n  * The move is rebroadcast to others in the channel\n3. On all clients:\n  * The `received` function runs in the Action Cable subscriptions which calls the `onReceiveMove` callback\n  * `onReceiveMove` calls `setCellValue` with the `triggerOnMoveCallback` option set to `false` so `onMove` isn't called again\n  * `setCellValue` updates the crossword gird\n\n### Working with Intermittent Connections\n\nIf the move can't be broadcast with Action Cable it's stored in the `MoveBuffer`. On reconnection:\n\n1. The remote state of the grid will be received from the server and updated\n2. The moves in the moves buffer will be replayed\n\nWhen the move `MoveBuffer` is replayed, moves will only apply if the cell they change still has the same character in it when the move was made. For example, if you change an 'A' to a 'B' while offline this move will be discarded if someone has since changed the 'A' to a 'C' and broadcast it to the server before you.\n\nThe `MoveBuffer` uses local storage so will persist if the page is refreshed or the browser is closed.\n\n## The Source of the Crosswords Data\n\nCrosswords are scraped from the Guardian Crossword pages which contain a JSON representation of each crossword. The crosswords are re-used following their [Open Licence Terms](https://syndication.theguardian.com/open-licence-terms/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzetter%2Fmulticrosser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzetter%2Fmulticrosser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzetter%2Fmulticrosser/lists"}