cassie961/castor_care_ghana

Castor Care Ghana Mobile Application # castor_care_ghana Castor Care Ghana is a production-grade Flutter app for agricultural commodities trading and operations, redesigned to match the branding and experience of castorcareghana.com. It includes both consumer-facing shopping flows and an admin dashboard for business operations, powered by Firebase and Riverpod, with modern animations and brand-consistent UI. --- ## Executive Summary This document provides a comprehensive overview of the Castor Care Ghana mobile application, including product scope, architecture, routing, dependencies, platform configuration, operational runbook, and future roadmap. It is intended for engineers, designers, QA, and stakeholders. __Objectives__ * Deliver a brand-aligned, modern mobile experience for agricultural commodities. * Provide secure authentication for users and a dedicated admin workspace. * Ensure scalable data access via Firebase services and robust navigation/state patterns. __Status (as of 2025-08-12)__ * Core user and admin experiences implemented and stable. * Some admin features are gracefully stubbed with Coming Soon screens. * Minor lints only; builds pass locally with Android minSdk 23. --- ## Branding & Design System * __Brand Source__: Castor Care Ghana website and visual identity. * __Typography__: Inter family (Regular 400, Medium 500, SemiBold 600, Bold 700) configured in `pubspec.yaml`. * __Color Direction__: Agricultural palette with primary orange and deep green accents aligned to site identity. * __Components__: Consistent use of custom-styled buttons, badges, cards, shimmer placeholders, and smooth animations. * __Assets__: Declared under `assets/images/`, `assets/animations/`, `assets/icons/`, `assets/fonts/`. --- ## Features * __Brand-Aligned UI__: Colors, typography, and visuals consistent with Castor Care Ghana. * __Onboarding & Auth__: - Role selection, splash, login, signup, forgot password. - Admin login and admin registration with secure key. * __User App__: - …