iOS · Android

An I Ching app for readings and reflection.

Wuxing combines three-coin I Ching readings with a searchable library of 64 hexagrams, a daily almanac, and a journal for saved questions and readings.

~/wuxing
Wuxing: screen 1

4,096

line readings

Platform
iOS · Android
Hexagrams
64
Line readings
4,096

$ cat ./challenge

Organizing 4,096 readings.

A cast uses three coins thrown six times to create a hexagram. The reading screen brings together its judgment, image, two trigrams, and changing lines, with optional ambient audio.

Each of the 64 hexagrams has six lines that can be changing or unchanging, giving 4,096 combinations. The app needs to retrieve these readings from a cast, a library search, the almanac, or a saved journal entry.

Users can follow a reading with a clarifying cast that carries the first hexagram forward. Both readings can be saved in the journal, which tracks days of practice and saved readings.

$ ./build --steps

How we approached it.

The design and development decisions behind the product.

  1. Three coins, six throws

    Users type or speak their question before casting. Ambient audio begins before the first line appears. Red marks identify changing lines directly on the hexagram.
  2. Search by name, meaning, or number

    The Sixty-Four library supports searches by name, meaning, or number and can be filtered by trigram. Users can find a hexagram again without remembering its number.
  3. Saved readings and practice history

    The Journal saves each reading with its question. The almanac marks casting days alongside solar terms and moon phases. Counters show "days cast in a row" and "kept this month".

$ ls ./shipped

What we developed.

Features and systems implemented for this product.

Today

The daily hexagram and its image, with a button to start a new three-coin reading.

The cast

Questions entered by keyboard or voice, optional clarifying casts, and ambient audio that users can pause or change during a reading.

The reading

The judgment and image, named upper and lower trigrams, and changing lines marked on the hexagram.

The Sixty-Four

All 64 hexagrams, searchable by name, meaning, or number and filterable by trigram.

The Almanac

Daily hexagrams shown alongside solar terms and moon phases, plus a yearly wheel of the twelve sovereign hexagrams.

The Journal

Searchable saved readings with their original questions and a view of the last two weeks of practice.

$ open ./screens

Product screenshots.

A closer look at the interface and its main features.

Wuxing: feature preview
Wuxing — Wuxing: three-coin readings, the hexagram library, and the daily hexagram
Wuxing: three-coin readings, the hexagram library, and the daily hexagram
Wuxing — The Journal

The Journal

Saved readings retain their questions. The top of the Journal shows the last two weeks of practice.

Wuxing — The Sixty-Four

The Sixty-Four

Search all 64 hexagrams by name, meaning, or number, or filter them by trigram.

Wuxing — The Almanac

The Almanac

Daily hexagrams appear alongside solar terms and moon phases.

$ cat stack.json

Technologies used.

  • Flutter
  • Dart
  • Riverpod
  • SQLite

$ ./start_project --like wuxing

Planning a product
like Wuxing?

Tell us what you have in mind. We will discuss the work involved, a possible timeline, and an estimate.