Skip to content

AtomicTrxn/crosscue

Repository files navigation

Crosscue

Your crossword puzzles. Your device. No strings attached.

Crosscue is a crossword solver for iOS and Android — built for people who want a clean, capable solver that stays out of their way. No subscription. No account. Your puzzles and progress live on your device.


What It Does

Import a .puz or .ipuz file from anywhere on your phone and start solving immediately. Crosscue also lets you download supported daily minis directly in the app. Crosscue handles the rest:

  • Full interactive grid — tap a cell to start, tap again to flip direction, swipe or use arrow keys to move
  • Physical and on-screen keyboard — works with Bluetooth keyboards and the soft keyboard alike
  • Check & reveal — check a letter, word, or the full grid; reveal when you're stuck; mistakes are tracked separately from reveals
  • Auto-save — close the app mid-solve and pick up exactly where you left off, timer included
  • Rebus support — multi-letter entries parsed and displayed correctly
  • Archive & stats — every completed puzzle recorded with time, date, and solve method; streaks tracked per local calendar date
  • Colorblind mode — deuteranopia-friendly blue/orange verification colors with / symbols, not color alone
  • Light, dark, and system theme
  • Optional iCloud sync (iOS) — opt in to keep puzzles, progress, and stats in sync across your devices through your own private iCloud account

Offline by Design

Crosscue stores puzzles, progress, history, and stats locally in a SQLite database on your device. There is no account, advertising, or analytics. When you choose to download a puzzle from an online source, the app makes the network request needed to fetch that puzzle.

Sync is off by default and account-free: if you turn on iCloud sync (iOS), your data moves directly between your devices and your own private iCloud account — it never passes through a Crosscue server (there isn't one).


Status

Available on iOS and Android. Core solving, importing, persistence, archive, stats, settings, and onboarding are feature-complete on both platforms. Active development is tracked in GitHub Issues.


Get Started

iOS

Install via TestFlight (beta) — invite available on request — or wait for the App Store release.

Android

Sideload the latest APK from Releases, or join the Play Store closed test (public production listing pending).

Build from source

cd crosscue
flutter pub get
flutter run                    # uses whichever device/simulator is connected
flutter run -d <device-id>     # explicit device — see `flutter devices`

See DEPLOYMENT.md for iOS-specific simulator + build + signing notes.


Developer Docs

Doc What's inside
CONTRIBUTING.md Commands, architecture summary, and contributor workflow
ARCHITECTURE.md Layer rules, feature structure, data flow, new-feature checklist
MODELS.md Every domain model, field list, and DB mapping
CONVENTIONS.md Hard coding rules — Freezed, Riverpod, Drift, routing, legal source guardrail
DEPLOYMENT.md Build, install, log capture, release pipeline, Play Store checklist
Crosscue Color Guide Current color system reference for light mode, dark mode, and accessibility palettes
Privacy Policy Public privacy policy for Play Store submission

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors