ElectroHub

A modern electronics catalog Android app built with Kotlin, Jetpack Compose, and Firebase Firestore. Browse products, compare prices, save wishlists, and contact the store — no in-app payments.

Features

• Home feed with banners, categories, featured & new arrivals
• Product search, filters, and detail pages
• Wishlist with offline Room cache
• Store locator, contact, and WhatsApp enquiry
• Offline-first sync from Firestore

Tech stack

Layer	Stack
UI	Jetpack Compose, Material 3, Coil
Architecture	Clean Architecture, Hilt, MVVM
Local	Room, Kotlin Flow
Remote	Firebase Firestore, Remote Config

App demo

Full walkthrough: Home → Categories → Wishlist → More (store contact, Call, WhatsApp).

▶ Watch demo video

Screenshots

Home	Categories	Wishlist

More — store & contact	More — app menu

Quick start

Android app

1. Open project in Android Studio
2. Copy app/google-services.json.example → app/google-services.json and fill in from Firebase Console
3. Run on emulator or device

Firebase catalog data

# Deploy Firestore rules (project root)
npm install
cp .firebaserc.example .firebaserc   # set your project id
npm run firebase:deploy:firestore

# Upload demo products, categories & banners
cd bulk-upload
npm install
cp serviceAccountKey.json.example serviceAccountKey.json   # add real Admin key
npm run check
npm run upload

See bulk-upload/README.md for CSV format, FIREBASE_DEPLOY.md for rules deploy, and SECURITY.md before publishing to GitHub or Play Store.

Before uploading to GitHub

Never commit these files (already in .gitignore):

• app/google-services.json
• bulk-upload/serviceAccountKey.json
• local.properties, keystores, .firebaserc

Committed templates: google-services.json.example, serviceAccountKey.json.example, .firebaserc.example.

git init
git add .
git status   # verify no secrets appear under "Changes to be committed"

Full security review: SECURITY.md · Pre-launch: PRE_LAUNCH_CHECKLIST.md

Project structure

ElectroHub/
├── app/                    # Android application
├── bulk-upload/            # CSV → Firestore upload scripts
├── firebase/               # Firestore & Storage security rules
├── docs/
│   ├── demo.mp4             # App walkthrough video (Git LFS)
│   └── screenshots/          # README showcase PNGs
├── SECURITY.md             # Secrets, API keys, GitHub upload checklist
├── PRE_LAUNCH_CHECKLIST.md # Play Store launch checklist
└── README.md

License

Private project — All rights reserved.