Skip to content

Viderspace/Arroword-Preview

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arroword - Collaborative Puzzle App

Arroword is a real-time, collaborative arrow-word puzzle-solving app for iOS built with SwiftUI and Firebase.
It brings live presence collaboration - similar to real-time document editing - to the world of arrow-word puzzles.

Users can upload a puzzle (from image, PDF, or live scan), invite friends, and solve it together - with each participant’s contributions shown live on the board in real time.


Highlights

Real-Time Collaborative Solving

Multiple users solve the same puzzle together in real time.
Each participant is assigned a unique color, which clearly communicates:

  • Where they are currently focused
  • Which cells they have filled
  • Which clue/path they are working on

State is synchronized using Firestore listeners, so all participants see updates instantly - with no manual refresh.


Lobby View & Collaborative Gamification

All active puzzles appear in the main lobby as cards, each showing a compact visual summary of the group’s progress:

  • A minimap of the board, with solved cells color-coded by the member who filled them.
  • Member badges above the minimap, ordered by contribution.
  • A stacked progress bar illustrating both overall completion and each member’s share.

This allows players to see progress at a glance and encourages friendly competition, while remaining lightweight through lazy loading and local snapshot caching.


Puzzle Upload & Board Recognition

Users can start a new shared puzzle group by importing:

  • A photo from the gallery
  • A PDF document with page selection (as shown to the right)
  • A live scan using VisionKit

Arroword then automatically detects the puzzle’s grid dimensions and initializes a structured puzzle board.


Automatic Puzzle Grid Detection

After a puzzle file, scan, or image is selected, Arroword automatically detects the grid dimensions and distinguishes definition cells from answer cells. The puzzle is then converted into a precise, coordinate-indexed grid model.

This enables:

  • Pixel-accurate zoom & pan
  • Consistent rendering across device sizes
  • Selectable clue paths with direction toggling
  • A smooth, touch-native solving experience

Any printed puzzle becomes a fully interactive, cell-accurate board - ready for collaborative play.


Deployment & Beta Testing (TestFlight)

Arroword has been distributed privately through TestFlight for real-world testing with multiple users. This allowed refinement of:

  • Interaction flow and control responsiveness
  • Real-time synchronization behavior across devices
  • Performance on different device sizes and OS versions

This ensures the app performs reliably outside the simulator and under real network conditions.


Upcoming Feature: Per-Riddle Chat

A built-in chat system is being developed, allowing members to discuss specific riddles directly on the board.
A long-press on a cell opens a chat scoped to that clue’s context.
This feature is currently being tested in latest builds and iterated based on feedbacks.


Project Status

Arroword is an active project in ongoing development.
The real-time collaboration, lobby experience, and core puzzle mechanics are fully implemented and tested with real users through private TestFlight distribution.
The codebase is currently private while the app is being prepared for broader release.

If you're reviewing this in the context of a role or collaboration, I’d be happy to walk through architecture and implementation details in conversation.

If you are an Android developer or interested in helping port the experience to Android, feel free to reach out - collaboration is welcome.


Author

Jonatan Vider
Product & Game Developer - Tel Aviv, Israel

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages