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.
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