Skip to content

A Progressive Web-App for getting a daily I Ching reading and sharing results.

License

Notifications You must be signed in to change notification settings

Adamhunter108/i-ching-typescript

Repository files navigation

I Ching ☯️

ℹ️ About:

A Progressive Web-App for getting a daily I Ching reading and sharing results.

🤔 What is the I Ching The I Ching, usually translated to Book of Changes, dates back to 1,000 BC. This several thousand year old book is regarded as a foundational text of eastern wisdom and philosophy. Originally a divination manual, the I Ching is meant to provide insight and guidance for moral decision making. An I Ching reading comes in the form of a Hexagram which consists of six lines which are either broken (yin) or unbroken (yang).

🔮 How to consult the I Ching Back in the day, people would throw yarrow stalks to calculate and construct their Hexagrams. Tossing coins, usually three at a time, is a more modern and convenient method. Those analog methods require calculations and often involve interpreting changing lines.
To use this app, all you need to do is press the Divinate button. We recommend doing only one reading a day and sitting with the result. Each Hexagram is unique and has a number. Feel free to google your Hexagram number to read more about it.

📲 How to install a pwa app
🖥️ Desktop
Currently, Google Chrome is the only browser with PWA support for desktop operating systems. In Google Chrome, after the page loads there will be an option to install the app in the address bar next to the share and star icons.

📱 Mobile
Safari iOS - Press the "Share" button and select "Add to Home Screen" from the popup.
Android Chrome - Press the "three dot" icon in the upper right to open the menu. Select "Add to Home screen".

Visit project: bookofchanges.app


📚 Tech Stack:

  • This is a Next.js progressive web-app written in TypeScript, styled with Tailwind CSS and deployed continuously to Vercel.
TypeScript React Tailwind CSS Next.js Node.js

💻 Local Development:

❗️ Requirements:

  • Node.js
$ # install dependencies
$ npm i
$ # start local development node.js server
$ npm run develop
$ # or
$ yarn develop


Bonus

For a Python CLI version of this app: github.com/Adamhunter108/i-ching