# Development Environment

**Document type:** Governance / Development Environment  
**Version:** 0.1.0  
**Status:** Draft  
**Language:** English  
**Product:** Chanora  
**Repo path:** `docs/governance/development-environment.md`

---

## 1. Purpose

This document records the intended local development environment for Chanora.

## 2. Required Toolchains

The exact versions shall be finalized when the Flutter and Rust workspaces are created.

Expected tools:

| Tool | Purpose |
|---|---|
| Flutter SDK | Cross-platform UI |
| Dart SDK | Flutter development |
| Rust toolchain | Core, protocol, audio, storage, diagnostics |
| Cargo | Rust package/build tool |
| just | Local command runner |
| Python 3 | Documentation validation scripts |
| Xcode | iOS/iPadOS/macOS development and App Store Connect upload builds |
| Android Studio / Android SDK | Android development |
| CMake / native build tools | Native dependencies if required |

## 3. Platform Notes

| Platform | Notes |
|---|---|
| iOS / iPadOS | App Store Connect upload on or after 2026-04-28 requires Xcode 26+ and iOS 26 / iPadOS 26 SDK+. |
| Android | Store upload must target the Google Play-required API level on upload date. |
| Desktop | Windows, macOS, and Linux build requirements shall be finalized during scaffold and release planning. |

## 4. Local Commands

Local commands are defined in `justfile`.

Initial commands:

```bash
just format
just lint
just test
just verify-docs
just security-scan
```

## 5. Change History

| Version | Date | Description |
|---|---|---|
| 0.1.0 | 2026-05-14 | Initial development environment document. |
