Clone
2
Home
Waozi edited this page 2026-11-20 05:42:52 +01:00

Inner Breeze

Inner Breeze is an open-source app for guided breathing, meditation, habits, and daily routines. Local practice works without an account. An account is available for optional sync across devices.

Use the app

Develop and test

Start in the Breeze repository on master. Follow the build guide for platform tools. The ziran.lock file pins the toolchain and dependencies.

Set ZIRAN_BUILD_DIR to the local build directory of the pinned toolchain containing bin/ziran. Populate the package cache before using --offline.

make -j2 ANDROID_ABI=arm64-v8a PACKAGE_FLAGS=--offline \
  ZIRAN="$ZIRAN_BUILD_DIR/bin/ziran" ZIRAN_BUILD_DIR="$ZIRAN_BUILD_DIR" android-debug
sh scripts/phone-install.sh --device pixel --apk build/android/app-arm64-v8a-debug.apk

This debug build installed and opened on Pixel with its existing app data.

For web development, use make web, then make site. See Web renderer tests for private browser testing. The public web app uses the published release bundle.

Architecture and troubleshooting

  • The Ziran host lives in src/. App packages live in apps/ and use the host interface for storage, rendering, and platform services. Host and app packages
  • If a build fails during law or version checks, start with the first reported error. Build laws
  • Use an HTTP localhost server or HTTPS to test browser persistence. Storage belongs to the exact site address. Export old local data or your sync key before switching origins. Sync recovery