Premium E-Commerce Mobile App for Bikes
Features • Screenshots • Tech Stack • Architecture • Getting Started
| Feature | Description |
|---|---|
| 🏠 Product Catalog | Browse 32+ premium bikes across 4 categories |
| 🔍 Animated Search | Full-screen search with real-time filtering |
| ❤️ Favorites | Save your favorite bikes for later |
| 🛒 Shopping Cart | Add items, adjust quantities, checkout |
| 📦 Order Tracking | View order history with status badges |
| 🎨 Glassmorphism UI | Modern frosted glass effects with gradients |
| ⚡ Smooth Animations | Staggered animations, transitions & gestures |
| 🌙 Dark Theme | Elegant dark mode design |
- Flutter 3.x - Cross-platform UI framework
- Dart 3.x - Programming language with null safety
- flutter_bloc - Predictable state management with Cubit pattern
- equatable - Value equality for state classes
- go_router - Declarative routing with deep linking support
- animate_do - Pre-built animations
- flutter_svg - SVG rendering
- google_fonts - Custom typography (Poppins)
- flutter_inset_shadow - Advanced shadow effects
- toastification - Beautiful toast notifications
- very_good_cli - Project scaffolding & best practices
- flutter_lints - Strict linting rules
lib/
├── app/ # App entry point & configuration
├── bikes/ # Products feature module
│ ├── cubit/ # Product & favorites state
│ ├── models/ # Product model
│ ├── repo/ # Repository abstraction
│ ├── view/ # Pages (catalog, detail)
│ └── widgets/ # Product cards, hero, search
├── cart/ # Shopping cart feature
│ ├── cubit/ # Cart state management
│ ├── models/ # Cart item model
│ └── widgets/ # Cart cards, summary
├── checkout/ # Checkout flow
│ ├── cubit/ # Checkout state
│ ├── models/ # Address model
│ └── widgets/ # Address card, slider
├── orders/ # Order history
│ ├── cubit/ # Orders state
│ ├── models/ # Order model
│ └── widgets/ # Order cards
├── core/ # Shared utilities
│ ├── theme/ # Colors, gradients, blur
│ ├── widgets/ # Reusable components
│ └── constants.dart # Magic numbers
├── navigation/ # Bottom tab navigation
├── routes/ # GoRouter configuration
└── l10n/ # Localization
- BLoC Pattern - Separation of UI and business logic
- Repository Pattern - Abstracted data sources
- Feature-first - Modular, scalable folder structure
- Immutable State - Predictable state updates with Equatable
- Flutter SDK
>=3.0.0 - Dart SDK
>=3.0.0 - Android Studio / VS Code
- Android Emulator or iOS Simulator
-
Clone the repository
git clone https://github.com/Anas-Altaf/bikex.git cd bikex -
Install dependencies
flutter pub get
-
Run the app
# Development flutter run --flavor development --target lib/main_development.dart # Production flutter run --flavor production --target lib/main_production.dart
# Android APK
flutter build apk --flavor production --target lib/main_production.dart
# Android App Bundle
flutter build appbundle --flavor production --target lib/main_production.dart
# iOS
flutter build ios --flavor production --target lib/main_production.dart| Category | Products | Price Range |
|---|---|---|
| ⚡ Electric | 8 bikes | $999 - $3,299 |
| 🏎 Road | 8 bikes | $899 - $2,199 |
| ⛰ Mountain | 8 bikes | $799 - $1,899 |
| 🏙 Urban | 8 bikes | $349 - $899 |
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Anas Altaf