✨ The Celestial Archive · 天穹秘典

A bilingual, local-first tarot reflection experience

Explore a complete 78-card tarot collection through a private and immersive experience designed for personal reflection and sharing with friends.

---

Overview

The Celestial Archive is a bilingual tarot reflection experience built around the complete collection of 78 tarot cards.

It is designed to provide a calm, personal, and accessible experience across mobile and desktop devices.

The core tarot experience works without hand tracking. The optional Hand Ritual uses local camera-based hand tracking with a tap fallback.

Highlights

• Complete 78-card tarot experience
• Bilingual interface
• Local-first privacy
• Mobile and desktop support
• Web, Android APK, and offline access
• Optional camera-based interaction
• User-controlled saving and exporting

Access the Project

Method	Best for	Link
Live web app	iPhone, iPad, Android, Windows, and macOS	Open The Celestial Archive
Installation guide	Step-by-step setup instructions	View the illustrated guide
Android APK	Standalone Android installation	Download Android APK v0.3.0
Offline package	Desktop use and local hosting	View the v0.3.4 release

Installation

iPhone and iPad

1. Open the live website in Safari.
2. Tap the Share button.
3. Select Add to Home Screen.
4. Tap Add.

The website is the supported version for iPhone and iPad. Apple devices do not use Android APK files.

Android

Install from the website

1. Open the live website in Chrome.
2. Open the Chrome menu.
3. Select Add to Home screen or Install app.

Install the Android APK

Download the standalone package:

Download Celestial Archive Android APK

Because this preview is distributed outside Google Play, Android may request permission to install applications from the selected source.

Windows

1. Download celestial-archive-friend-preview-v0.3.4.zip from the v0.3.4 release.
2. Right-click the ZIP file and select Extract All.
3. Open PowerShell inside the extracted folder.
4. Start a local server:

py -m http.server 47831

Alternatively:

python -m http.server 47831

5. Open this address in Chrome or Edge:

http://localhost:47831

macOS

1. Download and unzip celestial-archive-friend-preview-v0.3.4.zip.
2. Open Terminal inside the extracted folder.
3. Start a local server:

python3 -m http.server 47831

4. Open this address in your browser:

http://localhost:47831

Camera access requires the HTTPS website or a local server. Opening index.html directly through a file:// URL is not supported.

Privacy by Design

Readings remain on the user’s device unless the user deliberately saves or exports them.

Camera-based hand tracking is optional and is not required to use the main tarot experience.

The Celestial Archive is intended for reflection and entertainment. It does not provide medical, legal, financial, or predictive advice.

Project Status

Feature	Status
Core tarot experience	Available
Complete 78-card collection	Available
Mobile and desktop web access	Available
Android package	Available
Offline desktop package	Available
Hand Ritual gesture interaction	Available with tap fallback

Feedback

Feedback helps improve the experience, usability, and future features.

---

Created by ted0103