Dukaan Saathi (Flutter MVP)

Voice-first fintech Android app for Indian kirana stores, with premium dark dashboard UI.

Tech Stack

• Flutter (Material 3 custom dark theme)
• Provider (state management)
• Firebase Auth (OTP)
• Firestore
• Google Speech-to-Text (speech_to_text)
• Flutter TTS (flutter_tts)

Features Included

• Voice sales and stock command capture
• Conversational chat-style confirmation cards
• Stock management
• Udhar (credit) entry
• Expense tracking
• Profit tracking
• Sales analytics (today + week)
• Daily summary cards
• Moving-average stock prediction
• Hindi-ready text rendering support

UI Highlights

• Matte Black background: #0D0D0D
• Royal Indigo accent: #1A237E
• Indigo glow: #536DFE
• Premium gradient cards with rounded corners and soft glow
• Floating animated microphone action button
• Dark bottom navigation with active indigo indicator

Firestore Schema

Collections (all scoped by user_id):

• users
• products
• sales
• expenses
• customers
• credits

Voice Command Examples

• add 20 packets of soap to stock
• sold 3 soap for 90
• expense 500 electricity
• udhar 300 to ramesh

Setup

1. Install Flutter SDK and Android Studio.
2. In this folder, run:
   • flutter pub get
3. Configure Firebase:
   • Create Firebase project.
   • Enable Phone Auth.
   • Enable Firestore.
   • Add Android app and place google-services.json at android/app/google-services.json.
4. Add mic permission in Android manifest:
   • <uses-permission android:name="android.permission.RECORD_AUDIO"/>
5. Run app:
   • flutter run

Project Structure

• lib/main.dart
• lib/theme/app_theme.dart
• lib/models/
• lib/services/
• lib/providers/dukaan_provider.dart
• lib/screens/
• lib/widgets/

Notes

• This environment does not have Flutter installed, so platform folders (android/, ios/) were not auto-generated here.
• Generate full Flutter platform scaffolding by running flutter create . once Flutter is installed.