unitflow complete 20260819

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.rs]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false

.gitconfig.example

@@ -0,0 +1,7 @@
+[user]
+    name = Sanskar
+    email = sanskarin@outlook.in
+
+# Apply locally with:
+# git config user.name "Sanskar"
+# git config user.email "sanskarin@outlook.in"

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,56 @@
+name: Bug report
+description: Report a reproducible UnitFlow problem
+title: "bug: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: Thanks for helping improve UnitFlow. Remove private information before submitting logs or screenshots.
+  - type: textarea
+    id: summary
+    attributes:
+      label: What happened?
+      description: Describe the problem and what you expected instead.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: UnitFlow version or commit
+    validations:
+      required: true
+  - type: input
+    id: platform
+    attributes:
+      label: Platform and OS
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Select ...
+        2. Enter ...
+        3. Observe ...
+    validations:
+      required: true
+  - type: textarea
+    id: conversion
+    attributes:
+      label: Conversion details
+      description: Include source unit, destination unit, input, actual output, and expected output when relevant.
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs or screenshots
+      description: Optional. Remove secrets and personal information.
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checks
+      options:
+        - label: I searched existing issues for duplicates.
+          required: true
+        - label: I removed secrets and private information.
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,45 @@
+name: Feature request
+description: Suggest an improvement for UnitFlow
+title: "feat: "
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or opportunity
+      description: What user need would this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the behavior, UI, units, or workflow you would like.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Optional alternatives or tradeoffs.
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Rust core
+        - Flutter UI
+        - Unit catalog
+        - Accessibility
+        - Documentation
+        - Build and release
+        - Other
+    validations:
+      required: true
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checks
+      options:
+        - label: I searched existing issues for similar requests.
+          required: true

.github/pull_request_template.md

@@ -0,0 +1,21 @@
+## Summary
+
+Describe the problem and the focused change that solves it.
+
+## Validation
+
+- [ ] Rust checks/tests pass when Rust code changed.
+- [ ] Flutter analyze/tests pass when Flutter code changed.
+- [ ] Conversion constants/formulas have regression coverage when changed.
+- [ ] UI changes were checked on narrow and wide layouts.
+- [ ] Accessibility implications were reviewed.
+- [ ] Documentation/changelog were updated when needed.
+- [ ] No secrets or private information are included.
+
+## Screenshots
+
+Add screenshots for meaningful UI changes when useful.
+
+## Notes / limitations
+
+Call out migrations, compatibility concerns, follow-up work, or known limitations.

.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  rust:
+    name: Rust core
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cargo check
+        run: cargo check --manifest-path rust/Cargo.toml --all-targets
+
+      - name: Cargo test
+        run: cargo test --manifest-path rust/Cargo.toml
+
+  flutter:
+    name: Flutter app
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - name: Resolve packages
+        working-directory: app
+        run: flutter pub get
+
+      - name: Analyze
+        working-directory: app
+        run: flutter analyze
+
+      - name: Test
+        working-directory: app
+        run: flutter test

.gitignore

@@ -0,0 +1,30 @@
+# Rust
+/target/
+rust/target/
+Cargo.lock
+
+# Flutter / Dart
+.dart_tool/
+.packages
+.pub-cache/
+.pub/
+build/
+app/.flutter-plugins
+app/.flutter-plugins-dependencies
+app/.metadata
+
+# IDE
+.idea/
+.vscode/
+*.iml
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local files
+.env
+.env.*
+!.env.example
+coverage/
+*.log

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable UnitFlow changes are documented here.
+
+## [Unreleased]
+
+### Added
+
+- Rust high-precision conversion core using decimal arithmetic.
+- Searchable catalog covering length, mass, temperature, time, area, volume, speed, data, pressure, energy, power, and angle.
+- Explicit rounding options in the Rust engine.
+- Validated affine custom-unit formulas.
+- Rust command-line converter and unit catalog listing.
+- Flutter Material 3 frontend with responsive layout.
+- Searchable unit picker, category navigation, swap, copy, favorites, history, batch conversion, scientific notation, and precision controls.
+- Educational conversion explanations and accessibility semantics.
+- Cross-platform Flutter bootstrap scripts.
+- Rust and Flutter test suites.
+- CI, security, contribution, support, release, accessibility, performance, and architecture documentation.
+
+### Notes
+
+The Rust crate is the authoritative precision-focused engine. The current Flutter UI uses its dependency-free Dart adapter for immediate cross-platform execution while the documented native/WASM bridge remains a future integration milestone.
+
+## [0.1.0] - 2026-08-19
+
+Initial public development baseline.

CODE_OF_CONDUCT.md

@@ -0,0 +1,19 @@
+# Code of Conduct
+
+UnitFlow welcomes respectful, constructive collaboration.
+
+## Our standards
+
+Expected behavior includes:
+
+- Be respectful and patient in technical discussions.
+- Give actionable feedback focused on code, design, documentation, and outcomes.
+- Welcome contributors with different experience levels and backgrounds.
+- Respect privacy and do not publish personal information without permission.
+- Credit prior work and sources appropriately.
+
+Unacceptable behavior includes harassment, discrimination, threats, deliberate disruption, impersonation, publishing private information, or repeated hostile conduct.
+
+## Enforcement
+
+Report conduct concerns privately to `sanskarin@outlook.in`. Maintainers may remove content, restrict participation, close discussions, or take other proportionate moderation actions to protect the project community.

CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing to UnitFlow
+
+Thanks for improving UnitFlow.
+
+## Development setup
+
+1. Install a current stable Rust toolchain and Flutter SDK.
+2. Clone the repository.
+3. Configure the preferred commit identity when appropriate:
+
+```bash
+git config user.name "Sanskar"
+git config user.email "sanskarin@outlook.in"
+```
+
+4. Bootstrap Flutter platform folders when needed:
+
+```bash
+./tool/bootstrap_platforms.sh
+```
+
+On Windows PowerShell:
+
+```powershell
+./tool/bootstrap_platforms.ps1
+```
+
+## Before opening a pull request
+
+Run the complete quality suite:
+
+```bash
+cargo fmt --manifest-path rust/Cargo.toml --check
+cargo clippy --manifest-path rust/Cargo.toml --all-targets --all-features -- -D warnings
+cargo test --manifest-path rust/Cargo.toml
+
+cd app
+flutter analyze
+flutter test
+```
+
+## Change expectations
+
+- Keep conversion factors traceable and documented.
+- Add regression tests for conversion changes.
+- Avoid network requirements for static unit conversions.
+- Preserve accessibility labels and keyboard-friendly flows.
+- Keep UI logic separate from conversion logic.
+- Update `CHANGELOG.md` and `what_changed.md` for meaningful user-facing changes.
+- Never commit secrets, private keys, tokens, or credentials.
+
+## Commit style
+
+Use focused commits with descriptive Conventional Commit-style subjects, for example:
+
+- `feat(core): add pressure conversions`
+- `fix(app): preserve input after unit swap`
+- `test(core): cover affine temperature conversions`
+- `docs: explain release checklist`
+
+## Pull requests
+
+Explain the problem, implementation, validation performed, screenshots for UI changes when useful, and any remaining limitations.

Makefile

@@ -0,0 +1,18 @@
+.PHONY: rust-check rust-test flutter-get flutter-analyze flutter-test test
+
+rust-check:
+	cargo check --manifest-path rust/Cargo.toml --all-targets
+
+rust-test:
+	cargo test --manifest-path rust/Cargo.toml
+
+flutter-get:
+	cd app && flutter pub get
+
+flutter-analyze:
+	cd app && flutter analyze
+
+flutter-test:
+	cd app && flutter test
+
+test: rust-check rust-test flutter-get flutter-analyze flutter-test