Read this in other languages

🇨🇳 中文 · 🇮🇳 हिन्दी · 🇪🇸 Español · 🇫🇷 Français · 🇸🇦 العربية · 🇷🇺 Русский

acits_flutter

Flutter mobile client for acits.ru — free and open-source software for tracking animals inside an animal shelter.

Shelter staff and curators keep a live registry of the animals in their care: medical prescriptions, schedules, adoption applicants, documents and photos. The app ships in dev and prod flavors and talks to the ACITS backend over a generated OpenAPI client.

Tech stack

flutter_bloc (Cubit) · go_router · easy_localization · get_it + injectable · Chopper/Dio (OpenAPI) · Firebase · Patrol for e2e. Pinned to Flutter 3.44 / Dart 3.12 via FVM.

Quick start

git clone https://github.com/aiserrock/acits-flutter.git
cd acits-flutter
fvm install && fvm flutter pub get
fvm dart run build_runner build --delete-conflicting-outputs
fvm flutter run -t test/dev/main.dart --flavor dev

Firebase config files are gitignored — copy the *.example templates first (see CONTRIBUTING.md).

Builds

CI runs on pull requests (lint, analyse, test, build) — a plain merge to main/develop triggers nothing on its own, since the PR that landed it already went through the full pipeline.

Pushing a v* tag (e.g. v0.5.1) builds Android/iOS/web, publishes a GitHub Release with the dev APK attached, deploys the prod web build to GitHub Pages, and posts a build notification to the build notifications channel on Telegram.

Live PWA — the prod web build, installable as a Progressive Web App.

Documentation

• Contributing guide — setup, project structure, localization, testing, build and PR workflow.
• Wiki — architecture notes, flavors, and CI pipeline details.
• Security policy — supported versions and how to report a vulnerability.
• Code of conduct

Community

• Discussions — questions, ideas, and general chat.
• Issues — bug reports and feature requests.
• Build notifications on Telegram.

Contributions are welcome — see CONTRIBUTING.md before opening a pull request.

License

Released under the MIT License.