Skip to content

alfredang/daodejingapp

Repository files navigation

道德经 · Dao De Jing

A native iOS / iPhone reading app for Laozi's 《道德经》(Tao Te Ching) — the original classical-Chinese text with plain-language explanations and offline Mandarin text-to-speech.

Built with SwiftUI, fully offline, collects no data, no account required.

Download

Download 道德经 · Dao De Jing on the App Store

Download on the App Store

Dao De Jing — chapter list

Features

  • 诵读 / Read — core chapters of the 通行本 (received text), grouped into the book's six themes: 核心总纲 · 道之特性 · 修身境界 · 德之根基 · 治国用兵 · 处世智慧.
  • 原文 + 讲解 — each chapter shows the classical original alongside an easy-to-read modern Chinese explanation.
  • 朗读 / Read aloud — built-in Mandarin (zh-CN) speech via Apple's on-device AVSpeechSynthesizer, with an adjustable reading-speed slider. Works entirely offline.
  • 导读 / Overview — a guided introduction to the book's core ideas (核心思想) and its modern-day value (当代价值).
  • House-style bottom navigation — 阅读 (Read) · 反馈 (Feedback, via WhatsApp) · 关于 (About).

Screenshots

Read Chapter (read-aloud) Chapter About
Read Chapter 1 Chapter 8 About

Tech Stack

  • SwiftUI (iOS 16+), TabView + NavigationStack
  • AVFoundationAVSpeechSynthesizer for offline Mandarin TTS
  • XcodeGen — the Xcode project is generated from project.yml
  • A central Theme of semantic color tokens for automatic light/dark mode

Project Structure

Sources/
  DaoDeJingApp.swift      App entry point
  MainTabView.swift       Root bottom-tab navigation (Read / Feedback / About)
  Theme.swift             Semantic color tokens + card surface
  Models.swift            Chapter & BookSection models
  ChapterData.swift       The 道德经 content (original text + explanations)
  SpeechManager.swift     AVSpeechSynthesizer wrapper (zh-CN, speed/pitch)
  Views/                  ChapterList, ChapterDetail, Overview, Feedback, About
Resources/                Info.plist, Assets, PrivacyInfo.xcprivacy
scripts/                  App Store Connect submission tooling (signing, upload, metadata)

Build & Run

Requires Xcode 16+ and XcodeGen (brew install xcodegen).

xcodegen generate
open DaoDeJing.xcodeproj
# ⌘R on an iPhone simulator or device

Or build from the command line:

xcodegen generate
xcodebuild -scheme DaoDeJing -destination 'platform=iOS Simulator,name=iPhone 17' build

Content & Privacy

  • The 《道德经》 text is in the public domain; the explanations are original editorial content.
  • The app collects no data, requires no account, and runs fully offline (declared via Resources/PrivacyInfo.xcprivacy).

Acknowledgements

Developed by Tertiary Infotech Academy Pte Ltd.

About

Now live on the App Store. Native iOS / SwiftUI reading app for Laozi's 《道德经》(Tao Te Ching): original classical text, plain-language explanations, and offline Mandarin text-to-speech (AVSpeechSynthesizer).

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors