How yashn555/freeshop-billing works
FreeShop Billing is an offline-first Android invoicing app for small shops. A shop user registers or signs in, creates an invoice or quotation on the dashboard, and can save and view bills or generate a branded PDF; separate screens manage customers, products, and shop settings. The graph captures the documented capabilities and the sampled dashboard-to-data/PDF relationships. Several screen and ViewModel implementations were not sampled, so those connections are shown as unverified where needed.
Main entry points: AppNav.kt Navigation graph · DashboardViewModel.kt Billing logic · AppDatabase.kt Room database · BillPdfGenerator.kt PDF generator
Components 33
App navigation
- App entry
app/src/main/java/com/freeshop/billing/MainActivity.kt - Navigation graph
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Sign in / register
app/src/main/java/com/freeshop/billing/ui/viewmodel/AuthViewModel.kt - Session store
app/src/main/java/com/freeshop/billing/data/SessionStore.kt - Welcome screen
app/src/main/java/com/freeshop/billing/ui/screen/LandingScreen.kt - Login screen
app/src/main/java/com/freeshop/billing/ui/screen/LoginScreen.kt - Registration screen
app/src/main/java/com/freeshop/billing/ui/screen/RegisterScreen.kt
Billing workflow
- Invoice dashboard
app/src/main/java/com/freeshop/billing/ui/screen/DashboardScreen.kt - Billing logic
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Bills history
app/src/main/java/com/freeshop/billing/ui/screen/BillsScreen.kt - Bills logic
app/src/main/java/com/freeshop/billing/ui/viewmodel/BillsViewModel.kt - PDF generator
app/src/main/java/com/freeshop/billing/pdf/BillPdfGenerator.kt - Money utilities
app/src/main/java/com/freeshop/billing/domain/Money.kt
Shop management
- Customer management
app/src/main/java/com/freeshop/billing/ui/screen/CustomersScreen.kt - Customer logic
app/src/main/java/com/freeshop/billing/ui/viewmodel/CustomersViewModel.kt - Product catalog
app/src/main/java/com/freeshop/billing/ui/screen/ItemsScreen.kt - Product logic
app/src/main/java/com/freeshop/billing/ui/viewmodel/ItemsViewModel.kt - Shop settings
app/src/main/java/com/freeshop/billing/ui/screen/SettingsScreen.kt - Settings logic
app/src/main/java/com/freeshop/billing/ui/viewmodel/SettingsViewModel.kt
Local persistence
- Room database
app/src/main/java/com/freeshop/billing/data/db/AppDatabase.kt - Shop repository
app/src/main/java/com/freeshop/billing/data/repository/ShopRepository.kt - Bill repository
app/src/main/java/com/freeshop/billing/data/repository/BillRepository.kt - Customer repository
app/src/main/java/com/freeshop/billing/data/repository/CustomerRepository.kt - Product repository
app/src/main/java/com/freeshop/billing/data/repository/ProductRepository.kt - Shop records
app/src/main/java/com/freeshop/billing/data/db/dao/ShopDao.kt - Bill records
app/src/main/java/com/freeshop/billing/data/db/dao/BillDao.kt - Customer records
app/src/main/java/com/freeshop/billing/data/db/dao/CustomerDao.kt - Product records
app/src/main/java/com/freeshop/billing/data/db/dao/ProductDao.kt - Shop profile
app/src/main/java/com/freeshop/billing/data/db/entity/Shop.kt - Bill / quotation
app/src/main/java/com/freeshop/billing/data/db/entity/Bill.kt - Customer record
app/src/main/java/com/freeshop/billing/data/db/entity/Customer.kt - Product record
app/src/main/java/com/freeshop/billing/data/db/entity/Product.kt
Other components
- Shop user
Connections 44
- Shop user → App entry: opens app
- App entry → Navigation graph: starts navigation
app/src/main/java/com/freeshop/billing/MainActivity.kt - Navigation graph → Welcome screen: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Login screen: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Registration screen: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Invoice dashboard: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Bills history: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Customer management: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Product catalog: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Shop settings: routes to
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Sign in / register: uses
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Navigation graph → Session store: uses
app/src/main/java/com/freeshop/billing/ui/nav/AppNav.kt - Sign in / register → Session store: persists session
app/src/main/java/com/freeshop/billing/ui/viewmodel/AuthViewModel.kt - Sign in / register → Shop repository: authenticates shop
app/src/main/java/com/freeshop/billing/ui/viewmodel/AuthViewModel.kt - Invoice dashboard → Billing logic: submits bill
app/src/main/java/com/freeshop/billing/ui/screen/DashboardScreen.kt - Billing logic → Bill repository: saves bill
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Billing logic → Customer repository: loads customers
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Billing logic → Product repository: loads products
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Billing logic → Shop repository: loads shop
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Billing logic → PDF generator: generates PDF
app/src/main/java/com/freeshop/billing/ui/viewmodel/DashboardViewModel.kt - Bills history → Bills logic: queries history
app/src/main/java/com/freeshop/billing/ui/screen/BillsScreen.kt - Bills logic → Bill repository: manages bills
app/src/main/java/com/freeshop/billing/ui/viewmodel/BillsViewModel.kt - Customer management → Customer logic: manages customers
app/src/main/java/com/freeshop/billing/ui/screen/CustomersScreen.kt - Customer logic → Customer repository: accesses customers
- Product catalog → Product logic: manages catalog
app/src/main/java/com/freeshop/billing/ui/screen/ItemsScreen.kt - Product logic → Product repository: accesses products
- Shop settings → Settings logic: edits shop
app/src/main/java/com/freeshop/billing/ui/screen/SettingsScreen.kt - Settings logic → Shop repository: updates shop
- PDF generator → Bill / quotation: renders bill
app/src/main/java/com/freeshop/billing/pdf/BillPdfGenerator.kt - PDF generator → Shop profile: renders branding
app/src/main/java/com/freeshop/billing/pdf/BillPdfGenerator.kt - PDF generator → Money utilities: formats amounts
app/src/main/java/com/freeshop/billing/pdf/BillPdfGenerator.kt - Invoice dashboard → Money utilities: shows totals
app/src/main/java/com/freeshop/billing/ui/screen/DashboardScreen.kt - Room database → Shop records: provides DAO
app/src/main/java/com/freeshop/billing/data/db/AppDatabase.kt - Room database → Bill records: provides DAO
app/src/main/java/com/freeshop/billing/data/db/AppDatabase.kt - Room database → Customer records: provides DAO
app/src/main/java/com/freeshop/billing/data/db/AppDatabase.kt - Room database → Product records: provides DAO
app/src/main/java/com/freeshop/billing/data/db/AppDatabase.kt - Shop repository → Shop records: reads / writes
app/src/main/java/com/freeshop/billing/data/repository/ShopRepository.kt - Bill repository → Bill records: reads / writes
app/src/main/java/com/freeshop/billing/data/repository/BillRepository.kt - Customer repository → Customer records: reads / writes
app/src/main/java/com/freeshop/billing/data/repository/CustomerRepository.kt - Product repository → Product records: reads / writes
app/src/main/java/com/freeshop/billing/data/repository/ProductRepository.kt - Shop records → Shop profile: stores
app/src/main/java/com/freeshop/billing/data/db/dao/ShopDao.kt - Bill records → Bill / quotation: stores
app/src/main/java/com/freeshop/billing/data/db/dao/BillDao.kt - Customer records → Customer record: stores
app/src/main/java/com/freeshop/billing/data/db/dao/CustomerDao.kt - Product records → Product record: stores
app/src/main/java/com/freeshop/billing/data/db/dao/ProductDao.kt