Files
sfhorizont/CLAUDE.md
T

50 lines
3.7 KiB
Markdown
Raw Normal View History

2026-10-24 13:20:55 +02:00
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
2026-10-25 07:11:03 +01:00
This is "SkyContour" (project/code name: sfzenith), a Flutter application targeting iOS, Android, macOS, Linux, Windows, and web platforms. It is a horizon-profiling tool for astrophotography: the user pans the phone camera around the horizon to record azimuth→altitude points and exports them for N.I.N.A. (.hrz) and Stellarium (360° panorama landscape). The authoritative spec is the designer handoff in **docs/** — read docs/README.md first (then SPEC.md, ARCHITECTURE.md, FORMATS.md, design/tokens.json). **docs/SPECIFICATION.md** tracks project-level decisions, current status and the roadmap. The functional prototype is the pure Rust core (`core/`), the wasm-bindgen adapter (`wasm/src/lib.rs`) and the React frontend (`wasm/frontend/`); the Flutter app is a thin native shell that runs the web build in a WebView. App IDs: iOS `com.sagifer.skycontour.ios` (the plain ID is held by a free Personal Team registration), Android `com.sagifer.skycontour` — never change them once published; iOS signing team `8EQZ487TY9` (individual account, not the GARAND DESIGN company team); the visible name comes from `wasm/frontend/src/lib/app.js` (APP_NAME), iOS Info.plist CFBundleDisplayName and Android android:label.
2026-10-24 13:20:55 +02:00
## Common Commands
```bash
# Run the app
flutter run
# Run tests
flutter test
# Run a single test file
flutter test test/widget_test.dart
# Analyze code (lint)
flutter analyze
# Get dependencies
flutter pub get
# Build the Rust WASM engine (from wasm/)
wasm-pack build --target web
# Run Rust core tests incl. golden tests against docs/examples (from core/)
cargo test
# Build web bundle into assets/web/ for the Flutter shell
./scripts/build_web.sh
# Run the web prototype (from wasm/frontend/)
npm run dev
```
## Architecture
- **core/** (`sfzenith-core`): pure Rust, no I/O, no web-sys — profile, projection, fov, hrz, stellarium, zip, session. All math and file generation belongs here.
- **wasm/**: thin wasm-bindgen adapter (camera, canvas, orientation glue) + JS-facing wrappers of the core exporters. Profiles cross the boundary as a 360-value Float64Array (index = azimuth degree, measured frame); exporters apply the north offset.
- **wasm/frontend/**: Vite + React UI — `src/screens/` (Sites, Setup, Capture, Review, Export, Settings, Calibrate), `src/lib/` (wasm loader, store = localStorage + IndexedDB strips, camera/sensors, survey = capture session + cached wasm `HorizonSurvey`, files = save/share incl. Flutter handlers). Desktop testing: open with `?sim` for a keyboard-driven fake compass (arrow keys), `?skipWelcome` to skip the first-run screen.
- **i18n** (`wasm/frontend/src/i18n/`): every UI string goes through `t('key', params)`; English (`locales/en.js`) is the source and fallback; es, ar (RTL), de, hu, pl, fr, it, sk follow the system language, overridable in Settings. Plurals are objects keyed by Intl.PluralRules category. Add a key to **all** locale files and run `npm run i18n:check` (from wasm/frontend/). Native shell strings: tab labels come from the web app; iOS permission prompts live in `ios/Runner/<lang>.lproj/InfoPlist.strings`. Exported files (.hrz, landscape.ini) stay English.
2026-10-25 07:11:03 +01:00
- **lib/main.dart**: Flutter Android shell — serves `assets/web/` on localhost:47391 (`lib/local_server.dart`; the port is part of the storage origin, never change it) in an InAppWebView, recovers server/page after suspension, grants camera, saves PNGs to the gallery
2026-10-24 13:20:55 +02:00
- **test/**: Widget tests using `flutter_test` package
- Uses `flutter_lints` for static analysis (configured in `analysis_options.yaml`)
- SDK requirement: Dart ^3.11.1